Instruções passo a passo: criando um TableAdapter com várias consultas
Publicado: agosto de 2016
Neste passo a passo, você criará um TableAdapter em um conjunto de dados usando o Assistente para Configuração da Fonte de Dados. O passo a passo o conduz pelo processo de criação de uma segunda consulta no TableAdapter usando o Editando TableAdapters dentro do Designer do Conjunto de Dados.
As tarefas ilustradas neste passo a passo incluem:
Criando um novo projeto de Aplicativo do Windows.
Criando e configurando uma fonte de dados em seu aplicativo pela compilação de um conjunto de dados com o Assistente de Configuração de Fonte de Dados.
Abrindo o novo conjunto de dados no Designer de Conjunto de Dados.
Adicionando consultas ao TableAdapter com o Assistente de Configuração de Consulta do TableAdapter.
Pré-requisitos
Para concluir este passo a passo, você precisará de:
- Acesso ao banco de dados de exemplo Northwind (versão SQL Server ou Access). Para obter mais informações, consulte Como instalar bancos de dados de exemplo.
Criando um novo Aplicativo do Windows
A primeira etapa é criar um aplicativo do Windows.
Para criar um novo projeto de Aplicativo do Windows
No Visual Studio, no menu Arquivo, crie um novo projeto.
Escolha uma linguagem de programação no painel Tipos de Projetos.
Clique em Aplicativo do Windows no painel Modelos.
Nomeie o projeto como TableAdapterQueriesWalkthrough e clique em OK.
O Visual Studio adiciona o projeto ao Gerenciador de Soluções e exibe um novo formulário no designer.
Criando uma fonte de dados do banco de dados com um TableAdapter
Esta etapa cria uma fonte de dados usando o Assistente de Configuração de Fonte de Dados com base na tabela Customers no banco de dados de exemplo Northwind. É preciso ter acesso ao banco de dados de exemplo 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 a fonte de dados
No menu Dados, clique em Mostrar Fontes de Dados.
Na janela Fontes de Dados, selecione Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.
Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.
Na página Escolha a Conexão de Dados, faça o seguinte:
Se uma conexão de dados com o banco de dados de exemplo Northwind estiver disponível na lista suspensa, selecione-o.
-ou-
Selecione Nova Conexão para iniciar a caixa Adicionar/Modificar Conexão.
Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.
Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.
Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.
Selecione a tabela Clientes e clique em Concluir.
O NorthwindDataSet é adicionado ao projeto e a tabela Clientes aparece na janela Fontes de Dados.
Abrindo o conjunto de dados no Designer de Conjunto de Dados
Para abrir o conjunto de dados no Designer de Conjunto de Dados
Clique com o botão direito do mouse em NorthwindDataset na janela Fontes de Dados.
No menu de atalho, escolha Editar DataSet com Designer.
O NorthwindDataset é aberto no Designer de Conjunto de Dados.
Adicionando uma segunda consulta ao CustomersTableAdapter
O assistente criou o conjunto de dados com uma tabela de dados Clientes e o CustomersTableAdapter. Esta seção do passo a passo adiciona uma segunda consulta ao CustomersTableAdapter.
Para adicionar uma consulta ao CustomersTableAdapter
Arraste uma Consulta da guia DataSet da Caixa de Ferramentas para a tabela Clientes.
O Editando TableAdapters será aberto.
Selecione Usar instruções SQL e clique em Próximo.
Selecione SELECT que retorna linhas e clique em Próximo.
Adicione uma cláusula WHERE à consulta para que se leia:
SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = @CityDica
Se você estiver usando a versão Access do Northwind, substitua o parâmetro @City por um ponto de interrogação.(SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)
Na página Escolher Métodos a Serem Gerados, nomeie o método Preencher uma DataTable como FillByCity.
Dica
O método para Retornar uma DataTable não é usado neste passo a passo, portanto, você pode desmarcar a caixa de seleção ou manter o nome padrão.
Clique em Próximo e conclua o assistente.
A consulta FillByCity é adicionada ao CustomersTableAdapter.
Adicionando código para executar a consulta adicional ao formulário
Para executar a consulta
Selecione Form1 no Gerenciador de Soluções e clique em Designer de modos de exibição.
Arraste o nó Clientes da janela Fontes de Dados para Form1.
Altere o modo de exibição de código ao selecionar Código no menu Exibir.
Substitua o código no manipulador de eventos Form1_Load pelo código abaixo para executar a consulta FillByCity.
string cityValue = "Seattle"; customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);Dim cityValue As String = "Seattle" CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
Executando o aplicativo
Para executar o aplicativo
Pressione F5.
A grade é preenchida por clientes com um valor City de Seattle.
Próximas etapas
Para adicionar funcionalidade ao seu aplicativo
Adicione um controle TextBox e um controle Button e passe o valor na caixa de texto para a consulta. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Adicione a lógica de validação ao evento ColumnChanging ou RowChanging das tabelas de dados no conjunto de dados. Para obter mais informações, consulte Validar dados em conjuntos de dados.
Consulte também
Visão geral de TableAdapter
Criar e configurar TableAdapters
Como criar consultas TableAdapter
Instruções passo a passo de dados
Conectando a dados no Visual Studio
Preparando o aplicativo para receber dados
Buscando dados no aplicativo
Associar controles a dados no Visual Studio
Editando dados no aplicativo