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

Статья
11/05/2008

Обновлен: Ноябрь 2007

В этом руководстве создается адаптер таблицы в наборе данных с помощью Мастер конфигурации источников данных. Руководство демонстрирует процесс создания второго запроса в адаптере таблицы с помощью Мастер настройки запроса адаптера таблицы в Конструкторе наборов данных.

В этом пошаговом руководстве рассматриваются следующие задачи:

Создание нового проекта Приложение Windows.
Создание и настройка источника данных в приложении путем создания набора данных с помощьюМастера настройки источника данных.
Открытие нового набора данных в Конструкторе наборов данных.
Добавление запросов к адаптеру таблиц с помощью Мастера настройки запросов адаптера таблиц.

Обязательные компоненты

Для выполнения этого пошагового руководства потребуется следующее:

Доступ к учебной базе данных Northwind (версия для SQL Server или Access). Дополнительные сведения см. в разделе Практическое руководство. Установка образцов баз данных.

Создание нового приложения Windows.

Первым шагом является создание Приложения Windows.

Чтобы создать проект приложения Windows:

В Visual Studio в меню Файл создайте новый проект.
Выберите язык программирования в области Типы проектов.
Нажмите кнопку Приложение Windows в области Шаблоны.
Назовите проект TableAdapterQueriesWalkthrough и нажмите кнопку OK.

Visual Studio добавит проект в Обозреватель решений и откроет новую форму в конструкторе.

Создание источника данных базы данных с адаптером таблиц

На этом шаге создается источник данных с помощью Мастера настройки источника данных применительно к таблице Customers из учебной базы данных Northwind. Для создания подключения необходимо иметь доступ к демонстрационной базе данных Northwind. Сведения о настройке учебной базы данных Northwind см. в разделе Практическое руководство. Установка образцов баз данных.

Для создания источника данных,

В меню Данные выберите команду Показать источники данных.
Чтобы запустить Мастер настройки источника данных, выберите элемент Добавить новый источник данных в окне Источники данных.
На странице Выбор типа источника данных выберите элемент База данных и нажмите Далее.
На странице Выбор подключения базы данных выполните одно из следующих действий:
- Если подключение к учебной базе данных Northwind доступно в раскрывающемся списке, то выберите его.
  
  либо
- Выберите Новое подключение для открытия диалогового окна Добавить/изменить подключение. Дополнительные сведения см. в разделе Диалоговое окно "Добавить/Изменить подключение" (вкладка "Общие").
Если базе данных требуется пароль, выберите параметр для включения конфиденциальных данных и щелкните Далее.
Щелкните Далее на странице Сохранить строку подключения в файле конфигурации приложения.
Разверните узел Таблицы на странице Выбор объектов базы данных.
Выберите таблицу Customers и нажмите кнопку Готово.

Набор данных NorthwindDataSet будет добавлен к проекту, и таблица Customers появится в окне Источники данных.

Открытие набора данных в конструкторе наборов данных.

Для открытия набора данных в конструкторе наборов данных:

Щелкните правой кнопкой мыши на NorthwindDataset в окне Источники данных.
В контекстном меню выберите команду Редактировать набор данных с помощью конструктора.

Набор данных NorthwindDataset откроется в Конструкторе наборов данных.

Добавление второго запроса в CustomersTableAdapter

Мастер создал набор данных с таблицей данных Customers и с адаптером таблиц CustomersTableAdapter. В этом разделе руководства к CustomersTableAdapter добавляется второй запрос.

Для добавления запроса в CustomersTableAdapter:

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

Откроется Мастер настройки запроса адаптера таблицы.
Выберите Использовать SQL инструкции и нажмите кнопку Далее.
Выберите SELECT, который возвращает строки и нажмите кнопку Далее.

Добавьте предложение WHERE к запросу, чтобы он считывал:

SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
FROM Customers 
WHERE City = @City

Примечание.
При использовании Northwind в версии Microsoft Access, замените параметр @City вопросительным знаком. (SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)

На странице Выберите создаваемые методы назовите метод Заполнить таблицу данных (DataTable) как FillByCity.

Примечание.
Метод Вернуть таблицу данных (DataTable) не используется в данном руководстве, поэтому можно снять флажок или оставить имя по умолчанию.

Нажмите кнопку Далее и завершите работу мастера.

Запрос FillByCity добавляется в CustomersTableAdapter.

Добавление кода для выполнения дополнительных запросов на форму

Для выполнения запроса:

Выберите Form1 в Обозревателе решений и нажмите Открыть в конструкторе.
Перетащите узел Customers из окна Источники данных на Form1.
Перейдите на представление в виде кода, выбрав Код в меню Вид.

Замените код в обработчике событий Form1_Load следующими действиями, чтобы выполнить запрос FillByCity.

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

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

Запуск приложения

Чтобы выполнить приложение:

Нажмите клавишу F5.
Сетка заполняется клиентами со значением поля City, равным Seattle.

Следующие действия

Чтобы добавить функциональность в приложение:

Добавьте элементы управления TextBox и Button и передавайте значение из текстового поля в запрос. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text))
Добавьте логику проверки данных в события ColumnChanging или RowChanging таблиц в наборе данных. Дополнительные сведения см. в разделе Общие сведения о проверке данных.

См. также

Поделиться через