Практическое руководство. Создание запросов 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 с помощью Конструктора наборов данных:

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

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

    -или-

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

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

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

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

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

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

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

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

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

См. также

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