Porady: wykonywanie zapytań TableAdapter

Artykuł
08/17/2015

TableAdapter kwerendy są instrukcje SQL lub procedur przechowywanych, które aplikacji można wykonać w bazie danych i są narażone jako pismo metody TableAdapter. Tak jak w przypadku dowolnej metody dla dowolnego obiektu, można wykonywać kwerendy TableAdapter przez wywołanie metody skojarzone.

TableAdapter kwerendy można wypełnić tabelę danych (Fill i FillBy kwerend) lub return nowe tabele danych z danych zwróconych przez kwerendę (GetData i GetDataBy kwerend).

Kwerendy można dodać do istniejącej TableAdapters, uruchamiając TableAdapter Kreator konfiguracji zapytania.

Utworzenie wystąpienia TableAdapter

Przed wywołaniem jakichkolwiek metod jej, należy utworzyć wystąpienie TableAdapter.

Uwaga

Nawet TableAdapters są tworzone i edytowane za pomocą Projektant Dataset, TableAdapters, nie są klasy faktycznie zagnieżdżone wewnątrz elementu dataset.TableAdapters znajdują się w przestrzeni nazw, która jest identyfikowana na podstawie nazwy zestawu danych skojarzonych z TableAdapter.Konwencja nazewnictwa: DataSetName + "TableAdapters".Na przykład TableAdapters wszystkie skojarzone z NorthwindDataSet zostanie umieszczony w obszarze nazw NorthwindDataSetTableAdapters.Jeśli istnieje CustomersTableAdapter, a następnie jego w pełni kwalifikowana nazwa byłoby NorthwindDataSetTableAdapters.CustomersTableAdapter.

Aby utworzyć wystąpienie TableAdapter

Przeciągnij elementy z Źródła danych okna na formularzu w aplikacji systemu Windows, aby automatycznie utworzyć wystąpienie TableAdapter w formularzu. Inspekcje TableAdapter w panelu komponentów (mały obszar poniżej dolną krawędź formularza) dla nazwy instancji.

- lub -
Po utworzeniu TableAdapter, skompiluj projekt. TableAdapter następnie pojawia się w Przybornik. Przeciągnij TableAdapter z Przybornik na formularz, aby utworzyć wystąpienie. Inspekcje TableAdapter w panelu komponentów dla nazwy instancji.

- lub -

Programistyczne tworzenie instancji TableAdapter:

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

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

Wykonywanie kwerendy TableAdapter, które wypełniają tabele danych istniejących (metody Fill())

Aby wykonać kwerendę TableAdapter, która wypełnia istniejącej tabeli danych

Wywołanie TableAdapter Fill lub FillBy kwerendy i przebiegu w tabeli danych do wypełnienia. Na przykład, poniższy kod jest wykonywany Fill kwerendy i wypełnienia Customers tabeli:
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Wykonywanie kwerendy TableAdapter, które zwracają nowe tabele danych (GetData() metody)

Aby wykonać kwerendę TableAdapter, która zwraca nowej tabeli danych

Wywołanie TableAdapter GetData lub GetDataBy kwerendę, aby zwrócić tabelę danych wpisywanych wypełniona wyniki kwerendy. Na przykład, poniższy kod jest wykonywany GetData kwerendy i zwraca Customers tabeli:

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

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

Wykonywanie kwerendy TableAdapter, które zwracają pojedynczej wartości (skalar)

Można przeciągnąć kwerendę z Przybornik bezpośrednio na Projektant Dataset do tworzenia autonomicznych kwerendy (kwerenda tabeli nie danych).

Aby wykonać kwerendę TableAdapter który zwraca pojedynczą wartość (skalarne)

Utworzenie wystąpienia TableAdapter, zadeklarować zmienną do przechowywania wartości zwracanej i przypisać mu wynik kwerendy. W poniższym przykładzie założono, że istnieje kwerenda o nazwie 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();