Мастер настройки запроса адаптера таблицы

Обновлен: Ноябрь 2007

Мастер настройки запросов адаптеров таблиц помогает создавать и изменять дополнительные запросы, которые можно добавить адаптерам таблиц TableAdapter. Запросом адаптера таблицы TableAdapter является любой допустимый SQL-запрос или хранимая процедура, которые возвращают либо скалярное значение, либо данные, соответствующие той же схеме, что и таблица данных адаптера таблицы TableAdapter. После завершения работы мастера метод добавляется в адаптер таблицы TableAdapter, который при вызове выполняет запрос. (Например: CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)

Запуск мастера

Перетащите запросы в Конструктор наборов данных или настройте существующие запросы (любой запрос из перечисленных ниже первого).

Первый запрос в TableAdapter — это главный запрос TableAdapter. Изменение этого запроса открывает Мастер настройки адаптера таблицы и изменяет схему таблицы данных адаптера TableAdapter. Все запросы, перечисленные ниже главного запроса, являются дополнительными и настраиваются с помощью Мастера настройки запроса адаптера таблицы. Дополнительные сведения о запуске мастера содержатся в разделе Практическое руководство. Запуск мастера настройки запроса адаптера таблицы.

Выбор подключения к данным

Выберите существующее подключение из списка или нажмите Создать подключение, чтобы открыть Диалоговое окно "Добавить/Изменить подключение" (вкладка "Общие") и создать соединение с базой данных.

После завершения диалога Свойства подключения область Детали подключения отображает строку подключения и сведения только для чтения о выбранном поставщике.

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

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

Сохранение строк подключения в файле конфигурации приложения упрощает поддержание приложения при изменении соединения с базой данных. В случае изменения подключения к базе данных можно изменить строку подключения в файле конфигурации приложения. Таким образом, нет необходимости изменять исходный код и повторно компилировать приложение. Сведения о редактировании строки подключения в файле конфигурации приложения содержатся в разделе Практическое руководство. Изменение строки подключения.

Примечание о безопасности.
Сведения хранятся в файле конфигурации приложения в виде обычного текста. Для уменьшения вероятности несанкционированного доступа к конфиденциальным сведениям может потребоваться шифрование данных. Дополнительные сведения см. в разделе Шифрование и расшифровка данных.

Использование инструкций SQL

Этот раздел поясняет работу Мастера настройки запроса адаптера таблицы при выборе параметра Использовать инструкции SQL.

Выбор типа запроса

Мастер создает несколько типов запросов в зависимости от требований приложения. Можно выбрать запросы SELECT, возвращающие строки данных (таблицу данных) или запросы SELECT, возвращающие скалярное значение (одно значение, например Count или Sum).

На странице Выбор типа запроса выберите тип запроса для создания из списка.

Примечание.

Создание инструкции INSERT, UPDATE или DELETE не замещает команды адаптера таблицы TableAdapter, используемые при вызове метода Update адаптера таблицы TableAdapter. Например, при выборе UPDATE в качестве типа запроса будет создан новый запрос с именем, указанным позднее в мастере. Выполнение этого запроса происходит при вызове соответствующего метода TableAdapter. При вызове метода Update адаптера таблицы TableAdapter выполняются инструкции, созданные при исходной настройке TableAdapter.

Укажите инструкцию SQL <тип запроса>

На странице Выбор инструкции SQL введите инструкцию SQL для выполнения при вызове запроса.

Совет.
Мастер предоставляет доступ к Построителю запросов — визуальному средству для создания запросов на языке SQL. Чтобы открыть его, нажмите кнопку Построитель запросов. Дополнительные сведения об использовании Построителя запросов см. в разделе Средства конструктора запросов и представлений или нажмите клавишу F1 в этом диалоговом окне.

Выбор методов для автоматического создания

На этой странице находятся параметры для выбора методов, создаваемых мастером для запроса.

• Заполнить таблицу данных (DataTable)
  Создает метод для заполнения таблицы данных. Вы передаете имя таблицы данных в качестве параметра при вызове этого метода для заполнения таблицы данных возвращенными данными.

  При необходимости можно изменить имя по умолчанию в поле Имя метода. Задание наглядного имени может быть полезным при работе с этим запросом в коде.

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

  При необходимости можно изменить имя по умолчанию в поле Имя метода.

Выбор имени функции

Введите имя функции. Создание запроса адаптера таблицы TableAdapter добавляет в адаптер таблицы TableAdapter метод с введенным здесь именем. Вызовите этот метод, чтобы выполнить запрос. Задание наглядного имени может быть полезным при работе с этим запросом в коде.

Примечание.
При создании новых хранимых процедур предлагается ввести два имени. Первое имя является именем хранимой процедуры, созданной в базе данных; второе имя является именем метода в TableAdapter, выполняющего хранимую процедуру при вызове.

Создание новых хранимых процедур

Этот раздел поясняет работу с Мастером настройки запроса адаптера таблицы после выбора параметра Создать новые хранимые процедуры.

1. На странице Создать новые хранимые процедуры введите инструкцию SQL для выполнения при вызове хранимой процедуры.

   Примечание.
   Мастер предоставляет доступ к Построителю запросов — визуальному средству для создания запросов на языке SQL. Чтобы открыть его, нажмите кнопку Построитель запросов. Дополнительные сведения об использовании Построителя запросов см. в разделе Средства конструктора запросов и представлений или нажмите клавишу F1 в этом диалоговом окне.

2. На странице Создание хранимых процедур выполните следующие действия:

   1. Введите имя новой хранимой процедуры.

   2. Укажите, следует ли создать хранимую процедуру в основной базе данных.

      Примечание.
      Возможность создания хранимой процедуры в базе данных определяется параметрами безопасности для конкретной базы данных.

   На странице Просмотр результатов работы мастера отображаются результаты создания запроса TableAdapter. Если мастер обнаруживает неполадки, на этой странице представляются сведения об ошибках.

Использование существующих хранимых процедур

Этот раздел поясняет работу с Мастером настройки запроса адаптера таблицы после выбора параметра Использовать существующие хранимые процедуры.

1. Выберите существующую хранимую процедуру из раскрывающегося списка на странице Выбор существующей хранимой процедуры мастера.

   Параметры и Результаты для выбранной хранимой процедуры и отображаются для справки.

2. Нажмите кнопку Далее.

Выбор формы данных, возвращаемых хранимой процедурой

Тип данных, возвращаемых выбранной хранимой процедурой, определяет, как мастер создает методы TableAdapter.

Выберите тип данных, возвращаемых этим запросом.

• При выборе значения Табличные данные открывается страница Выбор методов для автоматического создания (описанная ранее на этой странице справки), которая позволяет указать типы, имена методов и поддержку разбиения по страницам.

• При выборе значения Одиночное значение создается типизированный метод, возвращающий одиночное значение. Этот параметр открывает страницу Выбор имени функции (описанную ранее на этой странице справки).

• При выборе значения Нет значения создается типизированный метод, который выполняет хранимую процедуру и не ожидает возвращаемых данных. Этот параметр открывает страницу Выбор имени функции (описанную ранее на этой странице справки).

Просмотр результатов работы мастера

На странице Просмотр результатов работы мастера отображаются результаты создания запроса TableAdapter. Если мастер сталкивается с проблемами, на этой странице отображаются подробные сведения.

См. также

Задачи

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

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

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

Новые возможности данных

Общие сведения об отображении данных

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

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

Начало работы с доступом к данным

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

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

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

Отображение данных на форме в приложениях Windows

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

Проверка данных

Сохранение данных