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

Запросы 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 и выберите команду Добавить запрос.)

Примечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих настроек или выпуска.Чтобы изменить параметры, выберите в меню Сервис пункт Импорт и экспорт параметров.Дополнительные сведения см. в разделеРабота с параметрами.

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

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

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

  2. Щелкните правой кнопкой мыши нужный TableAdapter и выберите Добавить запрос.

    – или –

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

    Откроется Мастер настройки запроса адаптера таблицы.

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

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

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

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

  1. Выберите TableAdapter в панели компонентов.

  2. Щелкните смарт-тег TableAdapter и выберите Добавить запрос.

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

См. также

Задачи

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

Практическое руководство. Подключение к данным в базе данных

Практическое руководство. Переход между данными с помощью элемента управления BindingNavigator в Windows Forms

Пошаговое руководство. Отображение данных на форме в приложении Windows

Пошаговое руководство. Создание адаптера таблицы с несколькими запросами

Основные понятия

Общие сведения об адаптере таблиц

конструктор наборов данных

Общие сведения об источниках данных

Другие ресурсы

Проверка данных