Практическое руководство. Выполнение запросов TableAdapter

Статья
02/20/2013

Запросы TableAdapter являются инструкциями SQL или сохраненными процедурами, которые приложение может выполнять в базе данных, запросы представляются как типизированные методы TableAdapter.Можно выполнять запросы TableAdapter, вызывая связанные методы, так же как любые методы на любом объекте.

Запросы TableAdapter могут заполнять таблицы данных (запросы Fill и FillBy) или возвращать новые заполненные таблицы данных по запросам ( запросы GetData и GetDataBy).

Можно добавить запросы для существующих TableAdapter, запустив мастер мастер настройки запроса TableAdapter.

Создание экземпляра TableAdapter

Необходимо создать экземпляр TableAdapter перед вызовом любого из его методов.

Примечание
Несмотря на то, что адаптеры TableAdapter создаются и редактируются с помощью Конструктора наборов данных, TableAdapter не являются вложенными классами в наборе данных.TableAdapter находится в пространстве имен, которое идентифицируется на основе имени набора данных, связанного с TableAdapter.Соглашение об именах: DataSetName + "TableAdapters".Например, все TableAdapter, связанные с NorthwindDataSet, будут находиться в пространстве имен NorthwindDataSetTableAdapters.Если имеется CustomersTableAdapter, то его полное имя будет NorthwindDataSetTableAdapters.CustomersTableAdapter.

Несмотря на то, что адаптеры TableAdapter создаются и редактируются с помощью Конструктора наборов данных, TableAdapter не являются вложенными классами в наборе данных.TableAdapter находится в пространстве имен, которое идентифицируется на основе имени набора данных, связанного с TableAdapter.Соглашение об именах: DataSetName + "TableAdapters".Например, все TableAdapter, связанные с NorthwindDataSet, будут находиться в пространстве имен NorthwindDataSetTableAdapters.Если имеется CustomersTableAdapter, то его полное имя будет NorthwindDataSetTableAdapters.CustomersTableAdapter.

Создание экземпляра TableAdapter

Перетащите элементы из окна Источники данных на форму в приложении Windows для автоматического создания экземпляра TableAdapter на форме.Проверьте имя экземпляра TableAdapter в области компонентов (небольшая область ниже нижней границы формы).

-или-
После создания TableAdapter постройте проект.TableAdapter появится в Панели элементов.Перетащите TableAdapter из Панели элементов на форму для создания экземпляра.Проверьте имя экземпляра TableAdapter в области компонентов.

-или-

Программное создание экземпляра TableAdapter:

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

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

Выполнение запросов TableAdapter на заполнение существующих таблиц данных (методы Fill())

Чтобы выполнить запрос TableAdapter, заполняющий существующую таблицу данных:

Вызовите запрос Fill или FillBy элемента TableAdapter и передайте в таблицу данных для заполнения.Например, следующий код выполняет запрос Fill и заполняет таблицуCustomers:
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Выполнение запроса TableAdapter, возвращающего новую таблицу данных (методы GetData())

Для выполнения запроса TableAdapter, возвращающего новую таблицу данных:

Вызовите запрос GetData или GetDataBy элемента TableAdapter для возврата таблицы типизированных данных, заполненной результатами выполнения запроса.Например, следующий код выполняет запрос GetData и возвращает таблицу Customers:
```
Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()
```
```
NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();
```

Выполнение запросов TableAdapter, возвращающих одиночные (скалярные) значения

Можно перетащить запрос из Панели элементов прямо в Конструктор наборов данных для создания изолированного запроса (запрос без таблицы данных).

Для выполнения запроса TableAdapter, возвращающего одиночное (скалярное) значение:

Создайте экземпляр TableAdapter, объявите переменную для хранения возвращаемого значения и присвойте ей результат выполнения запроса.В следующем примере предполагается, что имеется запрос с именем CustomerCount в 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();