Como: executar consultas do TableAdapter

Artigo
02/25/2013

Consultas no TableAdapter são instruções SQL ou procedimentos armazenados que seu aplicativo poderá executar em um banco de dados e são expostos como métodos tipados no TableAdapter.Você pode executar consultas no TableAdapter chamando os métodos associados, apenas como qualquer método em qualquer objeto.

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 Query Configuration Wizard.

Criar uma instância do TableAdapter

Você deve criar uma instância do TableAdapter antes de poder chamar os seus métodos.

Observação
Mesmo que TableAdapters sejam criados e editados usando o Dataset Designer, os TableAdapters não são realmente classes aninhadas num dataset.Os TableAdapters estão localizados em um namespace que é identificado com base no nome do dataset associado ao TableAdapter.É a convenção de nomeação: DataSetName + " TableAdapters ".Por exemplo, todos TableAdapters associados a NorthwindDataSet será localizado no espaço para o nome NorthwindDataSetTableAdapters.Se houver um CustomersTableAdapter, então seu nome totalmente qualificado será NorthwindDataSetTableAdapters.CustomersTableAdapter.

Mesmo que TableAdapters sejam criados e editados usando o Dataset Designer, os TableAdapters não são realmente classes aninhadas num dataset.Os TableAdapters estão localizados em um namespace que é identificado com base no nome do dataset associado ao TableAdapter.É a convenção de nomeação: DataSetName + " TableAdapters ".Por exemplo, todos TableAdapters associados a NorthwindDataSet será localizado no espaço para o nome NorthwindDataSetTableAdapters.Se houver um CustomersTableAdapter, então seu nome totalmente qualificado será NorthwindDataSetTableAdapters.CustomersTableAdapter.

Para criar uma instância do TableAdapter

Arraste itens da janela Data Sources em um formulário em seu aplicativo do Windows para criar automaticamente uma instância de um TableAdapter no formulário.Inspecione o TableAdapter na bandeja de componentes (a área pequena) abaixo borda inferior do formulário para o nome da instância.

- ou -
Após criar um TableAdapter, crie o projeto.O TableAdapter depois aparece no Toolbox.Arraste o TableAdapter da Toolbox em um formulário para criar uma instância.Inspecione o TableAdapter na bandeja de componentes para o nome da instância.

- ou -

Crie uma instância do TableAdapter programaticamente:

Dim CustomersTableAdapter1 As NorthwindDataSetTableAdapters.CustomersTableAdapter
CustomersTableAdapter1 = New NorthwindDataSetTableAdapters.CustomersTableAdapter()

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter1;
customersTableAdapter1 = new NorthwindDataSetTableAdapters.CustomersTableAdapter();

Executar consultas no TableAdapter que preenche as tabelas de dados existentes (métodos Fill())

Para executar uma consulta no TableAdapter que preenche uma tabela de dados existentes

Chame a consulta Fill ou FillBy do TableAdapter e passe a tabela de dados a ser preenchida.Por exemplo, o código a seguir executa a consulta Fill e preenche a tabela Customers:
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Executa consultas TableAdapter que retornar novas tabelas de dados (métodos GetData())

Para executar uma consulta no TableAdapter que retorna uma nova tabela de dados

Chame a consulta GetData ou GetDataBy do TableAdapter para retornar uma tabela de dados tipada preenchida com os resultados da consulta.Por exemplo, o código a seguir executa a consulta GetData e retorna uma tabela Customers:
```
Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()
```
```
NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();
```

Execute consultas no TableAdapter que retornar valores únicos (escalar)

Você pode arrastar diretamente uma consulta da Toolbox para o Dataset Designer para criar uma consulta autônoma (uma consulta com nenhuma tabela de dados).

Para executar uma consulta no TableAdapter que retorna um valor único (escalar)

Crie uma instância do TableAdapter, declare uma variável para conter o valor de retorno, e atribua o resultado da consulta.O exemplo a seguir pressupõe que existe uma consulta denominada CustomerCount no QueriesTableAdapter.

Dim scalarQueriesTableAdapter As NorthwindDataSetTableAdapters.QueriesTableAdapter
scalarQueriesTableAdapter = New NorthwindDataSetTableAdapters.QueriesTableAdapter()

Dim returnValue As Integer
returnValue = CType(scalarQueriesTableAdapter.CustomerCount(), Integer)

NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();

int returnValue;
returnValue = (int)scalarQueriesTableAdapter.CustomerCount();