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


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

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

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

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

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

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

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

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

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

Создание нового приложения 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:

    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