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

  • Статья

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

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

  • Создание нового проекта Приложение Windows.

  • Создание и настройка источника данных в приложении путем создания набора данных с помощьюМастера настройки источника данных.

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

  • Добавление запросов к адаптеру таблиц с помощью Мастера настройки запросов адаптера таблиц.

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

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

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

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

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

  1. В Visual Studio в меню Файл создайте новый проект.

  2. Выберите язык программирования в области Типы проектов.

  3. Нажмите кнопку Приложение Windows в области Шаблоны.

  4. Назовите проект TableAdapterQueriesWalkthrough и нажмите кнопку OK.

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

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

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

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

  1. В меню Данные выберите команду Показать источники данных.

  2. Чтобы запустить Мастер настройки источника данных, выберите элемент Добавить новый источник данных в окне Источники данных.

  3. На странице Выбор типа источника данных выберите элемент База данных и нажмите Далее.

  4. На странице Выбор подключения базы данных выполните одно из следующих действий:

  5. Если базе данных требуется пароль, выберите параметр для включения конфиденциальных данных и щелкните Далее.

  6. Щелкните Далее на странице Сохранить строку подключения в файле конфигурации приложения.

  7. Разверните узел Таблицы на странице Выбор объектов базы данных.

  8. Выберите таблицу Customers и нажмите кнопку Готово.

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

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

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

  1. Щелкните правой кнопкой мыши на NorthwindDataset в окне Источники данных.

  2. В контекстном меню выберите команду Редактировать набор данных с помощью конструктора.

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

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

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

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

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

    Откроется мастер настройки запроса TableAdapter.

  2. Выберите Использовать SQL инструкции и нажмите кнопку Далее.

  3. Выберите SELECT, который возвращает строки и нажмите кнопку Далее.

  4. Добавьте предложение 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 = ?)

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

    Примечание

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

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

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

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

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

  1. Выберите Form1 в обозревателе решений и нажмите Открыть в конструкторе.

  2. Перетащите узел Customers из окна Источники данных на Form1.

  3. Перейдите на представление в виде кода, выбрав Код в меню Вид.

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

См. также

Задачи

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

Практическое руководство. Создание запросов TableAdapter

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

Общие сведения об адаптере таблиц

Новые возможности разработки приложений для работы с данными

Привязка элементов управления к данным в Visual Studio

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

Пошаговые руководства работы с данными

Подключение к данным в Visual Studio

Подготовка приложения к получению данных

Выборка данных в приложение

Редактирование данных в приложении