Postupy: Provádění dotazů TableAdapter

Článek
08/17/2015

TableAdapter dotazy jsou příkazy SQL nebo uložené procedury, které lze spustit proti databázi a jsou vystaveny jako metody zadané na TableAdapter aplikace. TableAdapter dotazy můžete provést voláním metody přidružené stejně jako u jakékoli metody na libovolný objekt.

TableAdapter dotazy můžete vyplnit tabulku dat (Fill a FillBy dotazů) nebo vrátit nové tabulky dat naplněn dat vrácených dotazem (GetData a GetDataBy dotazy).

Dotazy můžete přidat do existujících TableAdapters spuštěním Průvodce nastavením dotazu TableAdapter.

Vytvořit instanci TableAdapter

Je nutné vytvořit instanci TableAdapter před volat jakékoliv metody jeho.

Poznámka

Přestože TableAdapters jsou vytvořeny a upravovány pomocí Dataset Návrhář, TableAdapters nejsou skutečně vnořené třídy v rámci objektu dataset.TableAdapters jsou umístěny oboru názvů, který je určen na základě názvu dataset přidružené TableAdapter.Konvence pro pojmenování je: DataSetName + "TableAdapters".Všechny TableAdapters, spojené s NorthwindDataSet například bude umístěn v oboru názvů NorthwindDataSetTableAdapters.Pokud je CustomersTableAdapter, pak by jeho plně kvalifikovaný název NorthwindDataSetTableAdapters.CustomersTableAdapter.

Vytvoření instance TableAdapter

Přetáhněte položky z Zdroje dat okna do formuláře v aplikaci pro systém Windows automaticky ve formuláři vytvořit instanci TableAdapter. Zkontrolujte TableAdapter v zásobníku komponenty (malá oblast pod dolní ohraničení formuláře) pro název instance.

-nebo-
Po vytvoření TableAdapter sestavení projektu. TableAdapter se objeví v nástrojů. Přetáhněte TableAdapter z nástrojů do formuláře pro vytvoření instance. Zkontrolujte TableAdapter na hlavním panelu komponenty pro název instance.

-nebo-

Programové vytvoření TableAdapter instance:

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

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

Spustit dotazy TableAdapter, které vyplnit stávající Data tabulky (metody Fill())

Provést dotaz TableAdapter, která vyplní existující tabulky dat

Volání TableAdapter Fill nebo FillBy dotazu a předat v tabulce dat k vyplnění. Například následující kód spustí Fill dotazu a výplní Customers tabulky:
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Spustit dotazy TableAdapter, které vracejí nové tabulky dat (GetData() metody)

K provedení TableAdapter dotazu, který vrátí nové tabulky dat

Volání TableAdapter GetData nebo GetDataBy dotaz vrátí zadaný dat tabulky s výsledky dotazu. Například následující kód spustí GetData dotaz a vrátí Customers tabulky:

Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()

NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();

Spustit dotazy TableAdapter, které jediné hodnoty (skalární)

Můžete přetáhnout z dotazu nástrojů přímo na Dataset Návrhář k vytvoření samostatného dotazu (dotaz s žádná tabulka dat).

Spuštění dotazu na TableAdapter, který vrací jedinou hodnotu (skalární)

Vytvořit instanci TableAdapter a deklarovat proměnnou držet vrácenou hodnotu přiřadit výsledek dotazu. Následující příklad předpokládá, že je dotaz s názvem CustomerCount na 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();