Compartilhar via


Como: Executar consultas do TableAdapter

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 Assistente de configuração da consulta TableAdapter.

Criar uma instância do TableAdapter

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

ObservaçãoObservaçã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 nomenclatura é: 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();
    

Consulte também

Tarefas

Como: Crie TableAdapters

Como: Criar consultas TableAdapter

Como: Editar consultas do TableAdapter

Como: Acessar diretamente o banco de dados com um TableAdapter

Demonstra Passo a passo: Salvando dados com os métodos DBDirect do TableAdapter

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

Demonstra Passo a passo: Exibindo dados em um Windows Form

Conceitos

Visão geral do TableAdapter

Vinculação de controles do Windows Forms a dados em Visual Studio

Dataset Designer

Visão geral sobre fontes de dados

Outros recursos

Buscando dados em seu aplicativo

Validando Dados