Postupy: Provádění dotazů TableAdapter

Článek
06/14/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();