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

Статья
02/20/2013

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

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

Создание нового проекта Приложение 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.

Откроется мастер настройки запроса TableAdapter.
Выберите Использовать 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 таблиц в наборе данных.Дополнительные сведения см. в разделе Проверка данных в наборах данных.

См. также

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

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

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

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

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

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

Создание источника данных

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

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

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

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

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

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

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

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

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

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

См. также

Задачи

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

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

Дополнительные ресурсы