Controle AccessDataSource em ASP.NET2.0

Autor：Eve Cole Data da Última Atualização：2009-06-30 16:37:44

O ASP.NET 2.0 inclui o controle AccessDataSource, que é usado para extrair dados do banco de dados Access para páginas do ASP.NET 2.0 (.aspx). As propriedades que este controle possui são muito simples. O atributo mais importante de AccessDataSource é o atributo DataFile, que é usado para apontar para o caminho do arquivo MDB no disco rígido. Outras propriedades pertencentes a AccessDataSource incluem SelectCommand, que é usado para definir uma instrução que exibe o conjunto de resultados (tabelas e colunas) que precisa ser retornado. SelectCommand deve ser definido usando a sintaxe SQL.

No VWD, existem duas maneiras de adicionar o controle AccessDataSource à página. Se o arquivo MDB for adicionado ao Database Explorer como no exemplo anterior, os nomes das colunas poderão ser arrastados e soltos na página, e o VWD criará automaticamente controles AccessDataSource e GridViews para exibir os dados. Se você não quiser usar o GridView ou quiser personalizar o controle, basta adicionar o controle AccessDataSource da caixa de ferramentas e instalá-lo por meio do assistente de configuração. O assistente solicitará que você procure o arquivo de dados e permitirá que você especifique um SelectCommand selecionando colunas na tabela do banco de dados. Se você entrar na página fora do VWD, poderá inseri-la da seguinte forma:

<asp:AccessDataSource>
ID="MeuNomeFonte"
Runat = "servidor"
DataFile="MeuNomeMDB.mdb"
SelectCommand="SELECT MeuCampo1, MeuCampo2 FROM MinhaTabela">
＜/asp:AccessDataSource＞

O recurso que precisa ser mencionado novamente é simples. Tudo que você precisa fornecer é um ID, um nome de arquivo MDB e um SelectCommand.

Este artigo é sobre controles de fonte de dados, mas lembre-se de que os controles de fonte de dados não tornam nada visível na página. Portanto, para fornecer uma maneira visual de testar o controle de fonte de dados, o próximo "Experimente" abordará as etapas básicas de uso do controle GridView (evoluído do controle DataGrid do ASP.NET versão 1) para exibir dados em uma tabela. Observe que o foco deste capítulo não está na configuração e customização do GridView, neste caso, o foco está no controle da fonte de dados. Posteriormente no Capítulo 5, o controle GridView será estudado com mais detalhes.

Tente #2 – Conecte-se ao MDB e exiba dados com GridView

No exemplo deste artigo, as informações dos produtos que foram vendidos serão exibidas através do Northwind na página.

(1) Inicie o editor de páginas e navegue até C:WebsitesBegAspNet2Dbch02.

(2) Adicione uma página chamada TIO-ch02-2-DisplayAccessData do modelo de formulário da Web. Clique no rótulo abaixo para alternar para o modo Design.

(3) No topo da página, insira um título como “Demonstração de conexão à fonte de dados MDB” e coloque o mesmo texto no título da página. Embora esta etapa não seja discutida em todos os exercícios, recomendamos incluir um título e um texto HTML em cada página para que a página que você está visualizando não seja perdida.

<html>
＜cabeça＞
＜título＞TIO ch02-1 Exibir dados MDB＜/título＞
＜cabeça＞
<corpo>
＜h3＞ch02 TIO 2 Demonstração de conexão a uma fonte MDB ＜/h3＞
<corpo>
＜/html＞

(4) Exiba a caixa de ferramentas (Menu: Exibir|caixa de ferramentas ou digite Ctrl+Alt+X) e expanda o painel Dados da caixa de ferramentas.

(5) Arraste um controle AccessDataSource para a página.

(6) O painel de tarefas conveniente do controle deve aparecer automaticamente. Se o painel não aparecer automaticamente, você pode selecionar a nova fonte de dados e clicar na pequena seta no canto superior direito para abrir o painel de tarefas conveniente. Clique em Configurar fonte de dados.

(7) Na etapa Escolher um banco de dados, clique no botão Procurar e selecione C:WebsitesBegAspNet 2DbApp_DataNorthwind.mdb, e observe que o designer converte a descrição do arquivo em uma referência relativa, ou seja, usando o símbolo (~) para representar o site no diretório raiz.

(8) Na caixa de diálogo Configurar instrução de seleção, selecione a opção Especificar colunas e selecione a tabela Produtos. Clique no asterisco para selecionar todas as colunas. Clique em Avançar, Testar Consulta e Concluir.

(9) Selecione o controle Dados e exiba a janela Propriedades pressionando F4. Altere seu ID para NorthwindProducts.

(10) Retorne ao painel Dados da caixa de ferramentas, clique duas vezes no GridView para adicionar o controle à página e entre no menu Tarefas Comuns e clique em Escolher Fonte de Dados. Selecione NorthwindProducts e encerre o assistente.

(11) Selecione GridView e altere seu ID para NorthwindProducts. A página deve ficar assim:

＜%@ idioma da página="VB" %＞
<html>
＜head＞＜title＞ch02 TIO 2 Exibir dados MDB＜/title＞＜/head＞
<corpo>
＜h3＞ch02 TIO 2 Demonstração de conexão a uma fonte MDB ＜/h3＞
＜form runat="servidor"＞
<asp:accessdatasource id="NorthwindProductsAccDataSource" runat="servidor"
selectcommand="Selecionar * Dos Produtos"
arquivo de dados="~/App_Data/Northwind.mdb">
＜/asp:accessdatasource＞
<asp:gridview id="NorthwindProductsGridView" runat="servidor"
datasourceid="NorthwindProductsAccDataSource">
＜/asp:gridview＞
＜/formulário＞＜/corpo＞＜/html＞

(12) Abra o navegador e visualize C:WebsitesBegAspNet2Dbch02ch02_TIO_2_DisplayAccessData.aspx (veja a Figura 2-2).

Figura 2-2

(13) A operação final é exibir os dados da Consulta MDB em vez da tabela. Feche o navegador e retorne ao VWD. Salve o arquivo com um novo nome ch02_TIO_2_DisplayAccessData-Query.aspx. Selecione o GridView e abra seu menu de tarefas comuns clicando na pequena seta no canto superior direito do controle. Clique em Configurar fonte de dados e em Avançar para ignorar a seleção do arquivo MDB. Na interface Configurar Instrução Select, altere o nome para "Classificação de Vendas" e clique no asterisco para obter todos os campos. Esta consulta une quatro tabelas usando JOIN, limita o número de registros usados em uma tabela e passa por algumas operações de agrupamento e agregação nos dados para obter o total. Clique em Avançar, testar a consulta e concluir. O controle da fonte de dados deve ficar assim:

<asp:accessdatasource id="NorthwindProductsAccDataSource" runat="servidor"
selectcommand="Selcet * De [Vendas por categoria]"
Arquivo de dados="~/App_Data/Northwind.mdb">
＜/asp:accessdatasource＞

(14) Abra o navegador e visualize a página.

Exemplo de nota nº 2 - Conecte-se ao MDB e exiba dados com GridView

Você tem dois controles na página. O primeiro, AccessDataSource, realiza todo o trabalho de conexão com os objetos ADO.NET que se conectam ao mecanismo JET que interage com o arquivo MDB. O segundo é o GridView, que serve para obter dados e converter seu formato em formato HTML que pode ser exibido na página. Observe que é muito importante dar a cada controle um nome significativo (ID). Você deve então certificar-se de que o controle vinculado a dados (GridView) usa sua propriedade DataSourceID para fazer referência ao ID do AccessDataSource para usar o AccessDataSource como sua fonte de dados.

Exibir dados de uma consulta não é muito difícil no Access, você pode usar nomes de consulta em vez de nomes de tabela. Existem duas instruções aqui. Primeiro, se houver espaços no nome de uma tabela ou consulta, o nome inteiro deverá ser colocado entre colchetes. Segundo, consultas que exigem informações do usuário (por exemplo, “vendas em um determinado ano” exigem saber em que ano) envolvem técnicas que estão além do escopo deste livro.

Após concluir as etapas anteriores, você poderá ver os dados obtidos do controle AccessDataSource exibidos na página. Os capítulos posteriores abordarão o GridView em detalhes, mas este capítulo continuará a focar nos controles de fonte de dados.

Selecione variáveis em declarações

Ao criar uma fonte de dados no VWD, o assistente solicitará que você especifique as colunas que precisam ser exibidas ou que crie uma instrução SQL personalizada. No "Try It Away" anterior, você simplesmente selecionou algumas colunas. Instruções SQL mais complexas podem ser especificadas de diversas maneiras diferentes:

● Use caixas de diálogo interativas

● Insira instruções SQL personalizadas no assistente AccessDataSource (chamado pela tarefa de conveniência Configurar fonte de dados no controle)

● Insira extratos na grade de propriedades

● Insira instruções diretamente na marcação da visualização Fonte

A seleção de colunas no assistente Access DataSource é uma técnica preferida para consultas simples que retornam uma ou mais colunas de uma tabela separada porque reduz erros de tipografia e sintaxe (veja a Figura 2-3). Neste assistente, você pode selecionar o nome da tabela ou consulta na lista suspensa Nome. Você pode então selecionar as colunas necessárias na tabela ou consulta selecionando todas as colunas (*) ou qualquer grupo de colunas. Se você clicar no botão Ordenar por, poderá classificar por qualquer coluna na fonte de dados. Caso haja restrição na primeira coluna, será utilizado o campo selecionado em Then By. Ao selecionar opções no assistente, observe que a sintaxe SQL real do SelectCommand também é exibida em uma caixa de texto somente leitura.

Figura 2-3

Você pode usar o botão WHERE no assistente para criar uma instrução SQL com parâmetros. Esta parte será apresentada no Capítulo 9. Iremos ignorar esta seleção por enquanto, mas é importante que antes da implantação você use esses parâmetros que serão discutidos posteriormente neste livro. Em um site implantado, evite conectar diretamente a entrada do usuário às instruções SQL. Ignorar problemas de parâmetros exporá seu site a ataques de injeção de SQL. Essa técnica de ataque usa caracteres falsos da entrada do usuário para invalidar a instrução SQL original e depois a substitui por uma instrução destrutiva. Você pode usar coleções de parâmetros para enviar entradas do usuário para coleções de parâmetros ADO.NET, que podem usar a funcionalidade de coleções para reduzir problemas de injeção de SQL.

Embora o assistente Configurar fonte de dados tenha muitas opções para ajudar a criar instruções SQL rapidamente, às vezes você ainda precisa inserir (ou modificar) diretamente a instrução SQL no SelectCommand marcado. O assistente AccessDataSource permite essas operações. Na página do assistente para seleção de tabelas, consultas e colunas, você pode selecionar o botão de opção para "Especificar uma instrução SQL personalizada ou procedimento armazenado". Após selecionar esta opção na página do assistente, clique no botão Avançar para entrar em outra página onde você pode inserir instruções personalizadas diretamente na área de texto. Você também pode usar o Visual Studio QueryBuilder para criar visualmente instruções personalizadas, usando ferramentas muito semelhantes ao Access QueryBuilder.

Se não quiser usar o assistente, você poderá optar por inserir uma instrução SQL personalizada na grade de propriedades do controle AccessDataSource ou alternar para o modo de exibição Fonte e inserir a instrução na propriedade SelectCommand da marca de controle AccessDataSource.

Existem muitos livros sobre SQL (do mesmo tipo que este é Beginning SQL Programming , ISBN 1-861001-80-0), e este livro fornece uma breve introdução no apêndice. Se você planeja aprender a sintaxe SQL, pode começar aprendendo os comandos para retornar parte de um registro (TOP e DISTINCT), a sintaxe para renomear um campo (AS) e a técnica para retornar campos de duas tabelas relacionadas (JOIN). . Os exercícios a seguir explorarão algumas variáveis em instruções SQL.

Tentativa nº 3 - Alterando a instrução Select em AccessDataSource Neste exercício, você exibirá colunas e registros específicos da tabela Produtos do Northwind. Também será criada uma página para exibir os dados obtidos na consulta. Observe que neste exercício as regras de seleção já estão no código-fonte. Atualmente, não há entrada do usuário como opção.

(1) Crie um arquivo chamado ch02_TIO_3_AlternateSelect-Commands.aspx em C:WebsitesBegAspNet2Dbch02.

(2) Adicione um controle AccessDataSource com Northwind como ID e defina o MDB como App_DataNorthwind.mdb. Em uma série de caixas de diálogo, configure o comando Selecionar para recuperar todos os campos da tabela Produtos ("nome"=Produtos). Dê uma olhada na visualização Fonte e observe a instrução que você criou, conforme mostrado abaixo:

SELECIONE * DE Produtos

(3) Adicione GridView, defina o ID como Northwind e defina a fonte de dados como Northwind. Esta é a aparência de toda a página até agora:

＜%@ idioma da página="VB" %＞
<html>
＜head runat="servidor"＞
＜title＞ch02 TIO 3 Alternate Select Conimands＜/title＞
＜/cabeça＞
<corpo>
＜h3＞ch02 TIO 3 Seleção Alternativa Coinmands＜/h3＞
＜form runat="servidor"＞
<asp:accessdatasource id="NorthwindAccDataSource" runat="servidor"
selectcommand="SELECIONE * DOS Produtos"
arquivo de dados=" ~/App_Data/Northwind.mdb" >
＜/asp:accessdatasource＞
<asp:gridview id="GridViewl" runat="servidor"
datasourceid="NorthwindAccDataSource">
＜/asp:gridview＞
＜/formulário＞
＜/corpo＞
＜/html＞

(4) Agora abra a página no navegador e preste atenção na interface mostrada na Figura 2-4 (nem todas as colunas são mostradas na captura de tela).

Figura 2-4

(5) Retorne à visualização Design e selecione AccessDataSource (não GridView). Abra seu prático painel de tarefas e clique em Configurar fonte de dados. Na janela Configurar instrução Select, selecione "Especificar uma instrução SQL personalizada" e clique em Avançar. Modifique a instrução SQL no editor da seguinte forma:

SELECIONE * DE [Produtos] ONDE (CategroyID=3)

(6) Clique em Avançar e teste a consulta. Clique em OK para fechar a caixa de diálogo. Dê uma olhada na página na visualização Fonte e observe o seguinte código:

<asp:accessdatasource id="NorthwindAccDataSource" runat="servidor"
selectcommand="SELECT * FROM [Produtos] WHERE (CategoryID = 3)"
Arquivo de dados="~App_Data/Northwind.mdb">
＜/asp:accessdatasource＞

(7) Tente usar a caixa de diálogo para criar alguns dos seguintes comandos de seleção. Você também pode inseri-los na visualização Fonte ou usar uma combinação dos dois.

SELECIONE * DE Produtos ONDE ProductID = 12
SELECIONE * FROM Produtos WHERE ProductName = 'Molho de Cranberry Northwoods'
SELECIONE * A PARTIR DE Produtos ONDE ProductID <11
SELECIONE * FROM Produtos WHERE ProductID <11 ORDER BY ProductName Crescente
SELECIONE * A PARTIR DE Produtos ONDE IDFornecedor = 6 OU IDFornecedor = 8
SELECIONE * A PARTIR DE Produtos ONDE IDDoFornecedor = 24 E PreçoUnitário ＞ 10

Exemplo de nota nº 3 - Alterando a instrução Select em AccessDataSource

Nas primeiras etapas, crie um controle AccessDataSource e um GridView como antes. Mas então comecei a experimentar instruções Select. Adicionar e remover colunas por meio de caixas de seleção é mais intuitivo. Você também pode inserir (ou editar) instruções SQL diretamente na janela do editor.

Uma cláusula WHERE foi adicionada para limitar os registros retornados do arquivo MDB. Se o nome da coluna não contiver espaços, os colchetes poderão ser omitidos. Esses colchetes devem ser usados se o nome da coluna contiver espaços.

Variáveis na localização do arquivo MDB

Os arquivos MDB são armazenados em vários locais físicos no disco rígido: na mesma pasta da página da Web, em uma subpasta da página da Web ou em outras pastas da máquina, etc. No Visual Web Developer, esses arquivos podem ser navegados frequentemente no designer e o caminho correto para o arquivo MDB foi inserido. No entanto, se você planeja inserir seu próprio código, precisará seguir a sintaxe descrita nesta seção.

A propriedade DataFile do controle AccessDataSource contém um caminho de página que pode ser totalmente qualificado (por exemplo, começando com uma letra de unidade) ou especificado em relação ao local da página que contém o AccessDataSource. Os caminhos também podem ser relativos ao aplicativo, ou seja, usar a sintaxe da URL para fazer referência ao caminho. Esta sintaxe substitui o símbolo (~) pelo diretório raiz do aplicativo, por exemplo: ~App_Dataproduces.mdb. O uso de caminhos relativos ao aplicativo facilita a movimentação de páginas de um local para outro sem quebrar as referências ao banco de dados, por isso é recomendado usar caminhos relativos ao aplicativo sempre que possível.

Primeiro, vejamos a sintaxe de um caminho totalmente qualificado, que contém o caminho completo para um arquivo MDB, começando pela raiz da unidade do computador onde o arquivo está localizado:

<asp:accessdatasource .

arquivo de dados = "C:WebSitesWebApplicationApp_DataMyMdb.mdb">

Embora esta sintaxe possa ser utilizada, sua desvantagem é que reduz a portabilidade da aplicação. Se você mover o aplicativo para outra máquina, o caminho completo para a unidade ou arquivo será diferente e você precisará modificar a propriedade DataFile sempre que mover a página.

Uma melhoria em relação aos caminhos totalmente qualificados é usar a sintaxe do caminho relativo, que requer apenas a especificação da parte do caminho totalmente qualificado que é diferente da página que contém o AccessDataSource. A seguir está a sintaxe do caminho para um arquivo de banco de dados na mesma pasta da página, especificada como um caminho relativo:

<asp:accessdatasource .

Como os arquivos de página e MDB estão no mesmo diretório, não há diferença nos caminhos desses arquivos, portanto, basta especificar seus respectivos nomes de arquivo; Se o MDB estiver em um ou mais diretórios abaixo da pasta, a sintaxe a seguir será muito semelhante à anterior. Neste caso, basta especificar o nome da subpasta, seguido de uma barra e do nome do arquivo MDF:

<asp:accessdatasource .datafile="MyDaughterFolder/MyMdb.mdb">.

Se o arquivo MDB estiver no diretório de nível superior do diretório de página, você também poderá usar a sintaxe de ponto duplo para especificar o diretório de nível superior do local atual:

<asp:accessdatasource .

Usando a sintaxe de caminho relativo, você pode mover aplicativos facilmente de um lugar para outro sem alterar o caminho do arquivo MDB. Como a página e o arquivo MDB são sempre inseparáveis (se o arquivo MDB fizer parte do aplicativo), as posições relativas desses arquivos serão sempre mantidas consistentes. Mas o que acontece quando você deseja mover um caminho dentro do aplicativo, como mover uma página para um subdiretório? Neste caso, a posição relativa entre a página e o arquivo MDB foi alterada e a sintaxe do caminho relativo está incorreta.

A sintaxe relativa do aplicativo resolve esse problema. Nesse caso, o caminho é sempre especificado em relação ao diretório raiz do aplicativo, e não em relação à página em si. O diretório raiz é representado pelo símbolo (~):

<asp:accessdatasource .

Agora você pode mover facilmente seu aplicativo ou mover páginas dentro de seu aplicativo sem alterar as referências ao banco de dados. Portanto, os caminhos relativos do aplicativo devem ser usados sempre que possível.