Como criar consultas TableAdapter

Artigo
06/10/2015

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 TableAdapter Assistente de Configuração de Consulta. (Clique com o botão direito do mouse em qualquer TableAdapter e escolha Add Query.)

Dica

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Criar uma consulta no DataSet Designer

Para adicionar uma consulta a um TableAdapter no DataSet Designer

Abra um dataset no Dataset Designer. Para obter mais informações, consulte Como abrir um conjunto de dados no Designer de Conjunto de Dados.
Clique com o botão direito do mouse no TableAdapter desejado e selecione Add Query.

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

O TableAdapter Query Configuration Wizard abre.
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 Pesquisar Construtor de Critérios, 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

Selecione um TableAdapter na bandeja do componente.
Clique na marca inteligente do TableAdapter e escolha Add Query.
Complete a caixa de diálogo e a consulta será adicionada ao TableAdapter. Para obter mais informações, consulte Caixa de diálogo Pesquisar Construtor de Critérios.