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

Статья
02/20/2013

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

Добавьте в TableAdapter столько запросов, сколько требуется в приложении.Запросы TableAdapter отображаются в виде методов на TableAdapter.При создании запроса с именем FillByCity, принимающего параметр, представляющий значение города, запрос добавляется в TableAdapter.Он добавляется в качестве типизированного метода, который принимает корректный тип параметра в качестве аргумента – в данном случае строку, представляющую значение города.Любой запрос TableAdapter вызывается так же, как любой метод на любом объекте.Например, следующий код выполняет запрос FillByCity и заполняет таблицу Customers значениями клиентов со значением города, равным Seattle:

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

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

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

Примечание
На вашем компьютере названия некоторых элементов интерфейса пользователя Visual Studio или их расположение могут отличаться от указанных в нижеследующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Параметры Visual Studio.

На вашем компьютере названия некоторых элементов интерфейса пользователя Visual Studio или их расположение могут отличаться от указанных в нижеследующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Параметры Visual Studio.

Создание запроса в Конструкторе наборов данных

Для добавления запроса в TableAdapter с помощью Конструктора наборов данных:

Откройте набор данных в Конструкторе наборов данных.Дополнительные сведения см. в разделе Практическое руководство. Открытие набора данных в конструкторе наборов данных.
Щелкните правой кнопкой мыши нужный TableAdapter и выберите Добавить запрос.

-или-
Перетащите Запрос из вкладки Набор данныхПанели элементов в таблицу Конструктора.

Откроется Мастер настройки запроса адаптера таблицы.
Завершите работу мастера; запрос добавляется к адаптеру таблицы.

Создание запроса непосредственно на форме в приложении Windows

Если на форме имеется экземпляр TableAdapter, можно добавить запрос с помощью Диалоговое окно "Построитель условий поиска", который добавляет элемент управления ToolStrip на форму, принимающую все входные параметры, необходимые запросу, а также содержит кнопку для выполнения запроса.

Добавление запроса в TableAdapter с помощью диалогового окна "Критерии поиска"

Выберите TableAdapter в панели компонентов.
Щелкните смарт-тег TableAdapter и выберите Добавить запрос.
Завершите работу диалогового окна, и запрос будет добавлен в TableAdapter.Дополнительные сведения см. в разделе Диалоговое окно "Построитель условий поиска".