Практическое руководство. Создание запросов TableAdapter
Опубликовано: Июль 2016
Запросы TableAdapter являются инструкциями SQL или сохраненными процедурами, которые приложение может выполнять в базе данных.
Добавьте в TableAdapter столько запросов, сколько требуется в приложении. Запросы TableAdapter отображаются в виде методов на TableAdapter. При создании запроса с именем FillByCity, принимающего параметр, представляющий значение города, запрос добавляется в TableAdapter. Он добавляется в качестве типизированного метода, который принимает корректный тип параметра в качестве аргумента – в данном случае строку, представляющую значение города. Любой запрос TableAdapter вызывается так же, как любой метод на любом объекте. Например, следующий код выполняет запрос FillByCity и заполняет таблицу Customers значениями клиентов со значением города, равным Seattle:
string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
Запросы TableAdapter могут заполнять таблицы данных (запросы Fill и FillBy) или возвращать новые заполненные таблицы данных по запросам ( запросы GetData и GetDataBy).
Можно добавить запросы для существующих TableAdapter, запустив мастер мастер настройки запроса TableAdapter. (Щелкните правой кнопкой мыши TableAdapter и выберите команду Добавить запрос.)
Примечание
Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в следующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Персонализация интегрированной среды разработки Visual Studio.
Создание запроса в Конструкторе наборов данных
Для добавления запроса в TableAdapter с помощью Конструктора наборов данных:
Откройте набор данных в Конструкторе наборов данных. Дополнительные сведения см. в разделе Практическое руководство. Открытие набора данных в конструкторе наборов данных.
Щелкните правой кнопкой мыши нужный TableAdapter и выберите Добавить запрос.
-или-
Перетащите Запрос из вкладки Набор данных Панели элементов в таблицу Конструктора.
Откроется Мастер настройки запроса адаптера таблицы.
Завершите работу мастера; запрос добавляется к адаптеру таблицы.
Создание запроса непосредственно на форме в приложении Windows
Если на форме имеется экземпляр TableAdapter, можно добавить запрос с помощью Диалоговое окно "Построитель условий поиска", который добавляет элемент управления ToolStrip на форму, принимающую все входные параметры, необходимые запросу, а также содержит кнопку для выполнения запроса.
Добавление запроса в TableAdapter с помощью диалогового окна "Критерии поиска"
Выберите TableAdapter в панели компонентов.
Щелкните смарт-тег TableAdapter и выберите Добавить запрос.
Завершите работу диалогового окна, и запрос будет добавлен в TableAdapter. Дополнительные сведения см. в разделе Диалоговое окно "Построитель условий поиска".
См. также
Общие сведения об адаптере таблиц
Практическое руководство. Изменение запросов TableAdapter
Создание и изменение типизированных наборов данных
Общие сведения об источниках данных
Практическое руководство. Подключение к данным в базе данных
Проверка данных
Практическое руководство. Переход между данными с помощью элемента управления BindingNavigator в Windows Forms
Пошаговое руководство. Отображение данных на форме в приложении Windows
Пошаговое руководство. Создание адаптера таблицы с несколькими запросами