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

Artigo
02/25/2013

In this walkthrough, you will create a TableAdapter in a dataset using the Data Source Configuration Wizard.The walkthrough takes you through the process of creating a second query in the TableAdapter using the TableAdapter Query Configuration Wizard 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 TableAdapter Query Configuration Wizard 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 DataTableFillByCity.

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