мастер настройки запроса TableAdapter
Мастер настройки запроса адаптера таблицы помогает создавать и редактировать дополнительные запросы, которые вы можете добавить в адаптеры таблицы. Запрос адаптера таблицы — это любой допустимый SQL-запрос или любая хранимая процедура, которые возвращают данные, соответствующие той же схеме, что и сопоставленная с адаптером таблицы таблица данных, (либо возвращающие скалярное значение). После завершения работы с матером в адаптер таблицы добавляется метод, который при вызове выполняет запрос. (Например, CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)
Запуск мастера
Перетащите запросы в Конструктор наборов данных или настройте имеющиеся запросы (любой запрос, указанный под первым запросом).
Первый запрос в адаптере таблицы является его основным запросом. При изменении этого основного запроса открывается Мастер настройки адаптера таблицы и изменяется схема таблицы данных адаптера таблицы. Все запросы, указанные под основным запросом, являются дополнительными, и для их настройки используется Мастер настройки запроса адаптера таблицы. Дополнительные сведения о выполнении мастера см. в разделе Практическое руководство. Запуск мастера настройки запроса адаптера таблицы.
Выбор подключения базы данных
Выберите существующее подключение из списка подключений или щелкните Создать подключение, чтобы создать подключение к базе данных.
После заполнения диалогового окна Свойства подключения в области Сведения о подключении отображается доступная только для чтения информация о выбранном поставщике, а также о строке подключения.
Сохранение подключения в файле конфигурации приложения
Выберите Да, сохранить подключение как, чтобы сохранить строку подключения в файле конфигурации приложения. Введите имя подключения или используйте имя по умолчанию.
Сохранение строк подключения в файле конфигурации приложения упрощает процесс обслуживания приложения в случае изменения подключения к базе данных. При изменении подключения к базе данных вы можете отредактировать строку подключения в файле конфигурации приложения. При этом вам не нужно изменять исходный код и перекомпилировать приложение. Сведения об изменении строки подключения в файле конфигурации приложения см. в разделе Практическое руководство. Сохранение и изменение строк подключения.
Важно!
Информация хранится в файле конфигурации приложения в виде обычного текста. Чтобы снизить вероятность несанкционированного доступа к конфиденциальной информации, вы можете зашифровать свои данные. Для получения дополнительной информации см. Encrypting and Decrypting Data.
Использовать инструкции SQL
Этот раздел описывает, как использовать Мастер настройки запроса адаптера таблицы, когда выбран параметр Использовать инструкции SQL.
Выбор типа запроса
Мастер создает несколько типов запросов в зависимости от потребностей вашего приложения. Вы можете выбрать запросы SELECT, которые возвращают строки данных (таблицу данных) или запросы SELECT, которые возвращают скалярное значение (отдельное значение, такое как Count или Sum).
На странице Выбор типа запроса выберите тип создаваемого запроса в списке доступных запросов.
Примечание
Создание инструкции INSERT, UPDATE или DELETE не заменяет собой команды адаптера таблицы, используемые при вызове его метода Update. Например, при выборе UPDATE в качестве типа запроса создается новый запрос с именем, которое задается на более позднем шаге в мастере. Для выполнения данного запроса вы вызываете этот именованный метод адаптера таблицы. Вызов метода Update адаптера таблицы выполняет инструкции, созданные при первоначальной настройке адаптера таблицы.
Укажите инструкцию SQL <тип запроса>.
На странице Укажите инструкцию SQL введите инструкцию SQL, выполняемую при вызове запроса.
Совет
Мастер предоставляет доступ к Построителю запросов — визуальному средству для создания SQL-запросов. Чтобы открыть его, нажмите кнопку Построитель запросов.
Выбор методов для автоматического создания
Параметры на этой странице позволяют выбрать, какие именно методы мастер создает для данного запроса.
Заполнить таблицу данных (DataTable)
Создает метод, служащий для заполнения таблицы данных. Вы передаете имя таблицы данных в качестве параметра при вызове этого метода для заполнения таблицы данных возвращенными данными.
Вы также можете изменить имя по умолчанию в поле Имя метода. Указание понятного имени может помочь при работе с данным запросом в коде.
Вернуть таблицу данных (DataTable)
Создает метод, служащий для возвращения заполненной таблицы данных. В некоторых приложениях может быть предпочтительнее возвращать заполненную таблицу данных, чем заполнять имеющуюся таблицу данных.
Вы также можете изменить имя по умолчанию в поле Имя метода.
Выбор имени функции
Введите имя для функции. При создании запроса адаптера таблицы в этот адаптер добавляется метод с указанным здесь именем. Вызовите этот метод для выполнения запроса. Указание понятного имени помогает при работе с данным запросом в коде.
Примечание
При создании новых хранимых процедур вам требуется указать два имени. Первое имя — это имя хранимой процедуры, создаваемой в базе данных; второе имя — это имя метода в адаптере таблицы, выполняющего хранимую процедуру при вызове.
Создать новые хранимые процедуры
Этот раздел описывает, как использовать Мастер настройки запроса адаптера таблицы, когда выбран параметр Создать новые хранимые процедуры.
На странице Создание хранимых процедур введите инструкцию SQL, выполняемую при вызове хранимой процедуры.
Примечание
Мастер предоставляет доступ к Построителю запросов — визуальному средству для создания SQL-запросов. Чтобы открыть его, нажмите кнопку Построитель запросов.
На странице Создание хранимых процедур выполните следующие действия.
Введите имя новой хранимой процедуры.
Укажите, требуется ли создавать хранимую процедуру в основной базе данных.
Примечание
Возможность создания хранимой процедуры в базе данных определяется параметрами безопасности и разрешениями, установленными для этой конкретной базы данных.
Страница Просмотр результатов работы мастера показывает результаты создания запроса адаптера таблицы. Если мастер сталкивается с проблемами, на этой странице выводятся сведения об ошибке.
Использовать существующие хранимые процедуры
Этот раздел описывает, как использовать Мастер настройки запроса адаптера таблицы, когда выбран параметр Использовать существующие хранимые процедуры.
Выберите существующую хранимую процедуру в раскрывающемся списке на странице Выбор существующей хранимой процедуры мастера.
Параметры и Результаты для выбранной хранимой процедуры отображаются для справки.
Нажмите кнопку Далее.
Выбор формы данных, возвращаемых хранимой процедурой
Тип данных, возвращаемых выбранной хранимой процедурой, определяет, как именно мастер создает методы адаптера таблицы.
Выберите тип данных, возвращаемых этим запросом.
При выборе значения Табличные данные открывается страница Выбор методов для автоматического создания (описанная ранее на этой странице справки), на которой можно указать создаваемые типы методов, имена методов и поддержку страничного обмена.
При выборе параметра Одиночное значение создается типизированный метод, возвращающий отдельное значение. Этот параметр открывает страницу Выбор имени функции (описанную ранее на этой странице справки).
При выборе параметра Значение отсутствует создается типизированный метод, выполняющий хранимую процедуру и не ожидающий возврата данных. Этот параметр открывает страницу Выбор имени функции (описанную ранее на этой странице справки).
Просмотр результатов работы мастера
Страница Просмотр результатов работы мастера показывает результаты создания запроса адаптера таблицы. Если мастер сталкивается с проблемами, на этой странице выводятся соответствующие сведения.
См. также
Общие сведения об адаптере таблиц
Практическое руководство. Изменение запросов TableAdapter
Пошаговые руководства работы с данными
Привязка элементов управления Windows Forms к данным в Visual Studio
Общие сведения о приложениях для работы с данными в Visual Studio
Подключение к данным в Visual Studio
Подготовка приложения к получению данных
Выборка данных в приложение
Привязка элементов управления к данным в Visual Studio
Редактирование данных в приложении
Проверка данных
Сохранение данных