Demonstra Passo a passo: Criando um TableAdapter com múltiplas consultas

Artigo
08/01/2011

In this walkthrough, you will create a TableAdapter in a dataset using the Assistente de Configuração de Fonte de Dados. The walkthrough takes you through the process of creating a second query in the TableAdapter using the Assistente de configuração da consulta TableAdapter within the Dataset Designer.

As tarefas ilustradas neste passo a passo incluem:

Criando um novo projeto Windows Application.
Criando e configurando uma fonte de dados em seu aplicativo, criando um DataSet com o Data Source Configuration Wizard.
Abrindo o novo DataSet no Dataset Designer.
Adicionando consultas ao TableAdapter com o TableAdapter Query Configuration Wizard.

Pré-requisitos

Para concluir esta explicação passo a passo, você precisa:

Acesso ao banco de dados de exemplos Northwind (versão do SQL Server ou do Access). Para obter mais informações, consulte Como: Instalar bancos de dados de amostra.

Criando um novo aplicativo Windows

A primeira etapa consiste em criar um aplicativo do Windows.

Para criar um novo projeto de Aplicativo do Windows

In Visual Studio, from the File menu, create a new project.
Escolha uma linguagem de programação no painel Project Types.
Clique em Windows Application no painel Templates.
Nomeie o projeto TableAdapterQueriesWalkthrough, e clique OK.

O Visual Studio adiciona o projeto ao Solution Explorer e exibe um novo formulário no designer.

Criar uma fonte de dados de banco de dados com um TableAdapter

This step creates a data source using the Data Source Configuration Wizard based on the Customers table in the Northwind sample database. Você deve ter acesso ao banco de dados de exemplos Northwind para criar a conexão. Para obter informações sobre como configurar o banco de dados de exemplo Northwind, consulte Como: Instalar bancos de dados de amostra.

Para criar o DataSet

No menu Data, clique em Show Data Sources.
Na janela Data Sources, selecione Add New Data Source para iniciar o Data Source Configuration Wizard.
Selecione Database na página Choose a Data Source Type, e clique Next.
Na página Choose your Data Connection siga um destes procedimentos:
- Se uma conexão de dados para o banco de dados de exemplo Northwind estiver disponível na lista drop-down, selecione-o.
  
  - ou -
- Selecione New Connection para iniciar a caixa Add/Modify Connection. Para obter mais informações, consulte Adicionar/modificar a caixa de diálogo de conexão (geral).
Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.
Clique Next na página Save connection string to the Application Configuration file.
Expanda o nó Tables na página Choose your Database Objects.
Selecione a tabela Customers, e clique Finish.

O NorthwindDataSet é adicionado ao seu projeto e a tabela Customers aparece na janela Data Sources.

Abrindo o DataSet no Dataset Designer

Para abrir o DataSet no Dataset Designer

Clique com o botão direito do mouse NorthwindDataset na janela Data Sources.
No menu de atalho, escolha Edit DataSet with Designer.

O NorthwindDataset abre no Dataset Designer.

Adicionando uma segunda consulta ao CustomersTableAdapter

O assistente criou o DataSet com uma tabela de dados Customers e CustomersTableAdapter. Essa seção da explicação passo a passo adiciona uma segunda consulta para o CustomersTableAdapter.

Para adicionar uma consulta para o CustomersTableAdapter

Arraste um Query da guia DataSet da tabela Toolbox para a tabela Customers.

The Assistente de configuração da consulta TableAdapter opens.
Selecione Use SQL statements, e clique Next.
Selecione SELECT which returns rows, e clique Next.

Adicione uma cláusula WHERE à consulta para que ela seja lida:

SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
FROM Customers 
WHERE City = @City

Observação
Se você estiver usando a versão Access do Northwind, substitua o parâmetro @City com um ponto de interrogação. (SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)

Na página Choose Methods to Generate, nomeie o método Fill a DataTable FillByCity.

Observação

O método Return a DataTable não é usado neste explicação passo a passo, então você possa desmarcar a caixa de seleção ou deixar o nome padrão.
Clique em Next e conclua o assistente.

A consulta FillByCity é adicionada ao CustomersTableAdapter.

Observação
O método Return a DataTable não é usado neste explicação passo a passo, então você possa desmarcar a caixa de seleção ou deixar o nome padrão.

Adicionando código para executar a consulta adicional no formulário

Para executar a consulta

Selecione Form1 no Solution Explorer, e clique em View Designer.
Arraste o nó Customers da janela Data Sources para Form1.
Altere para modo de exibição de código, selecionando Code a partir do menu View.

Replace the code in the Form1_Load event handler with the following to run the FillByCity query.

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

Executando o aplicativo

Para executar o aplicativo

Pressione F5.
The grid is filled with customers with a City value of Seattle.

Próximas etapas

Para adicionar funcionalidade a seu aplicativo

Add a TextBox control and Button control and pass the value in the text box to the query. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Adicione lógica de validação ao evento ColumnChanging ou RowChanging das tabelas de dados no conjunto de dados. Para obter mais informações, consulte Validação de dados em Datasets.

Consulte também

Compartilhar via