Compartilhar via


Como: Criar consultas TableAdapter

Consultas TableAdapter são instruções SQL ou procedimentos armazenados que seu aplicativo pode executar em um banco de dados.

Adiciona tantas consultas para um TableAdapter quanto seu aplicativo requer. Consultas TableAdapter aparecem como métodos em um TableAdapter. When you create a query called FillByCity that takes a parameter representing the city value, the query is added to the TableAdapter. Ela é adicionada como um método digitado que leva o tipo correto do parâmetro como um argumento — no caso uma sequência representando o valor de cidade. Você chama a consulta TableAdapter assim como qualquer método em qualquer objeto. For example, the following code executes the FillByCity query and fills the Customers table with all customers with a city value of Seattle:

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

TableAdapter queries can fill a data table (Fill and FillBy queries) or return new data tables populated with the data returned by the query (GetData and GetDataBy queries).

You can add queries to existing TableAdapters by running the Assistente de configuração da consulta TableAdapter. (Clique com o botão direito do mouse em qualquer TableAdapter e escolha Add Query.)

ObservaçãoObservação

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Criar uma consulta no DataSet Designer

Para adicionar uma consulta a um TableAdapter no DataSet Designer

  1. Abra um dataset no Dataset Designer. Para obter mais informações, consulte Como: Abra um Dataset no Dataset Designer.

  2. Clique com o botão direito do mouse no TableAdapter desejado e selecione Add Query.

    - ou -

  3. Arraste um Query da tabela DataSet da Toolbox em uma tabela no designer.

    O TableAdapter Query Configuration Wizard abre.

  4. Conclua o assistente; a consulta é adicionada ao TableAdapter.

Criar uma Consulta Diretamente em um Formulário no seu Aplicativo Windows

If you have an instance of a TableAdapter on your form you can add a query using the Caixa de Diálogo Construtora de Critérios de Pesquisa, which adds a ToolStrip control to the form that accepts any input parameters required by the query, as well as a button to run the query.

Para adicionar uma consulta a um TableAdapter usando a caixa de diálogo critérios de pesquisa

  1. Selecione um TableAdapter na bandeja do componente.

  2. Clique na marca inteligente do TableAdapter e escolha Add Query.

  3. Complete a caixa de diálogo e a consulta será adicionada ao TableAdapter. Para obter mais informações, consulte Caixa de Diálogo Construtora de Critérios de Pesquisa.

Consulte também

Tarefas

Como: Editar consultas do TableAdapter

Como: Conectar-se a Dados em um Banco de Dados

Como: Navegar em Dados com o Controle BindingNavigator do Windows Forms

Demonstra Passo a passo: Exibindo dados em um Windows Form

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

Conceitos

Visão geral do TableAdapter

Dataset Designer

Visão geral sobre fontes de dados

Outros recursos

Validando Dados