Compartilhar via


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

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.

Tarefas ilustradas nesta explicação 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:

Criando um novo aplicativo Windows

A primeira etapa consiste em criar um aplicativo do Windows.

Para criar um novo projeto de Aplicativo do Windows

  1. In Visual Studio, from the File menu, create a new project.

  2. Escolha uma linguagem de programação no painel Project Types.

  3. Clique em Windows Application no painel Templates.

  4. 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 exemplo.

Para criar o DataSet

  1. No menu Data, clique em Show Data Sources.

  2. Na janela Data Sources, selecione Add New Data Source para iniciar o Data Source Configuration Wizard.

  3. Selecione Database na página Choose a Data Source Type, e clique Next.

  4. 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 Conexão Caixa de diálogo Box (Geral).

  5. Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.

  6. Clique Next na página Save connection string to the Application Configuration file.

  7. Expanda o nó Tables na página Choose your Database Objects.

  8. 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

  1. Clique com o botão direito do mouse NorthwindDataset na janela Data Sources.

  2. 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

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

    The Assistente de configuração da consulta TableAdapter opens.

  2. Selecione Use SQL statements, e clique Next.

  3. Selecione SELECT which returns rows, e clique Next.

  4. 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 = ?)

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

    Observação:

    O método para Retornar uma DataTable não é usado nesta explicação passo a passo, então você possa desmarcar a caixa de seleção ou deixar o nome padrão.

  6. Clique em Next e conclua o assistente.

    A consulta FillByCity é adicionada ao CustomersTableAdapter.

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

Para executar a consulta

  1. Selecione Form1 no Solution Explorer, e clique em View Designer.

  2. Arraste o nó Customers da janela Data Sources para Form1.

  3. Altere para modo de exibição de código, selecionando Code a partir do menu View.

  4. 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

Consulte também

Tarefas

Como: Crie TableAdapters

Como: Criar consultas TableAdapter

Conceitos

Visão geral do TableAdapter

O que Há de Novo em Dados

Outros recursos

Explicações Passo a passo sobre Dados

Conectando-se a Dados no Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo

Exibindo dados em formulários em aplicativos do Windows

Editar dados no seu aplicativo