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

 

Опубликовано: Июль 2016

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

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

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

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

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

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

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

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

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

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

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

Порядок создания нового проекта приложения Windows

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

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

3. Щелкните Приложение Windows в области Шаблоны.

4. Присвойте проекту имя TableAdapterQueriesWalkthrough и нажмите кнопку ОК.

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

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

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

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

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

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

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

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

   • Если подключение к учебной базе данных Northwind доступно в раскрывающемся списке, то выберите его.

     -или-

   • Выберите Новое подключение для открытия диалогового окна Добавить/изменить подключение.

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

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

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

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

   Объект NorthwindDataSet добавляется в проект, и таблица Клиенты отображается в окне Источники данных.

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

Порядок открытия набора данных в Конструкторе наборов данных

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

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

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

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

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

Порядок добавления запроса в CustomersTableAdapter

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

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

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

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

4. Добавьте в запрос предложение WHERE, чтобы он имел следующий вид:

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

   Примечание

   Если вы используете версию базы данных "Борей" для 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. Перетащите узел Клиенты из окна Источники данных на Form1.

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

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

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

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

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

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

• Нажмите клавишу F5.

• Сетка заполняется клиентами, у которых City имеет значение Seattle.

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

Добавление функциональности в приложение

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

• Добавьте логику проверки данных в событие ColumnChanging или RowChanging таблиц данных в наборе данных. Для получения дополнительной информации см. Проверка данных в наборах данных.

См. также

Общие сведения об адаптере таблиц
Практическое руководство. Создание адаптера таблицы
Практическое руководство. Создание запросов TableAdapter
Пошаговые руководства работы с данными
Подключение к данным в Visual Studio
Подготовка приложения к получению данных
Выборка данных в приложение
Привязка элементов управления к данным в Visual Studio
Редактирование данных в приложении