Практическое руководство. Создание запросов TableAdapter
Обновлен: Ноябрь 2007
Запросы 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 и выберите команду Добавить запрос.)
.gif "Примечание") Примечание. |
|---|
Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих параметров или версии среды. Для изменения параметров выберите в меню Сервис команду Параметры импорта и экспорта. Дополнительные сведения см. в разделеПараметры Visual Studio. |
Создание запроса в Конструкторе наборов данных
Для добавления запроса в TableAdapter с помощью Конструктора наборов данных:
Откройте набор данных в Конструкторе наборов данных. Дополнительные сведения см. в разделе Практическое руководство. Открытие набора данных в конструкторе наборов данных.
Щелкните правой кнопкой мыши нужный TableAdapter и выберите Добавить запрос.
либо
Перетащите Запрос из вкладки Набор данныхПанели элементов в таблицу Конструктора.
Откроется Мастер настройки запроса адаптера таблицы.
Завершите работу мастера; запрос добавляется к адаптеру таблицы.
Создание запроса непосредственно на форме в приложении Windows
Если на форме имеется экземпляр TableAdapter, можно добавить запрос с помощью Диалоговое окно "Построитель условий поиска", который добавляет элемент управления ToolStrip на форму, принимающую все входные параметры, необходимые запросу, а также содержит кнопку для выполнения запроса.
Добавление запроса в TableAdapter с помощью диалогового окна "Критерии поиска"
Выберите TableAdapter в панели компонентов.
Щелкните смарт-тег TableAdapter и выберите Добавить запрос.
Завершите работу диалогового окна, и запрос будет добавлен в TableAdapter. Дополнительные сведения см. в разделе Диалоговое окно "Построитель условий поиска".
См. также
Задачи
Практическое руководство. Изменение запросов TableAdapter
Практическое руководство. Подключение к данным в базе данных
Пошаговое руководство. Отображение данных на форме в приложении Windows
Основные понятия
Общие сведения об адаптере таблиц
Общие сведения об отображении данных
Общие сведения об источниках данных