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

Статья
02/20/2013

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

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

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

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

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

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

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

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

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

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

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

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

Выберите тип команды

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

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

Использовать инструкции SQL позволяет ввести инструкцию SQL для выборки данных из базы данных.
Создать новые хранимые процедуры: выберите этот параметр, чтобы мастер создал новые хранимые процедуры (в базе данных) на основе указанной инструкции SELECT.
Использовать существующие хранимые процедуры: выберите этот параметр, чтобы сопоставить уже существующие в базе данных хранимые процедуры инструкциям адаптера данных SELECT, INSERT, UPDATE и DELETE.

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

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

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

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

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

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

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

Эта страница предоставляет параметры для выбора методов адаптера данных, которые мастер создает для получения и обновления данных.

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

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

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

Создание методов для отправки обновлений непосредственно в базу данных
Создает инструкции INSERT, UPDATE и DELETE, необходимые для записи изменений в основную базу данных.Выбор этого флажка эквивалентно заданию свойству GenerateDBDirectMethods значения true.

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

Этот параметр недоступен, если исходная инструкции SQL не содержит достаточно сведений или запрос не допускает обновление.Такая ситуация может произойти, например, в запросах JOIN и запросах, которые возвращают одиночное значение (скалярное).

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

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

На странице Создать хранимые процедуры введите инструкцию SQL, заполняющую таблицу данных.Это будет инструкция SELECT адаптера таблицы и базис для создания хранимых процедур для выбора, обновления, вставки и удаления данных.

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

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

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

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

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

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

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

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

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

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

Выберите хранимую процедуру, выполняемую для команд TableAdapter SELECT, INSERT, UPDATE и DELETE.Эти хранимые процедуры выполняются при вызове соответствующих методов адаптера таблиц.Например, хранимая процедура, связанная с командой UPDATE, выполняется при вызове метода TableAdapter.Update().

Сопоставьте параметры из выбранной хранимой процедуры соответствующим столбцам в таблице данных.Например, если хранимая процедура принимает параметр с именем @CompanyName, который передается в столбец CompanyName в таблице, задайте для Столбца источника параметра @CompanyName значение CompanyName.

Примечание
Хранимая процедура, связанная с командой SELECT, выполняется путем вызова метода адаптера таблиц, названного на предыдущем шаге мастера.По умолчанию этой процедурой является Fill, поэтому типичный код для выполнения процедуры SELECT выглядит так: TableAdapter.Fill(tableName).Замените Fill другим именем при изменении используемого по умолчанию Fill, и замените "TableAdapter" фактическим именем адаптера таблиц (например, CustomersTableAdapter).

Хранимая процедура, связанная с командой SELECT, выполняется путем вызова метода адаптера таблиц, названного на предыдущем шаге мастера.По умолчанию этой процедурой является Fill, поэтому типичный код для выполнения процедуры SELECT выглядит так: TableAdapter.Fill(tableName).Замените Fill другим именем при изменении используемого по умолчанию Fill, и замените "TableAdapter" фактическим именем адаптера таблиц (например, CustomersTableAdapter).

Дополнительные параметры

Щелкните элемент Дополнительные параметры, чтобы получить доступ к следующим дополнительным параметрам адаптера таблиц.

Создать инструкции Insert, Update и Delete

При выборе этого параметра, мастер попытается создать инструкции INSERT, UPDATE и DELETE на основе инструкции SELECT, заданной на странице Создание инструкций SQL.
Использовать оптимистическую блокировку

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

Выбор этого параметра обновляет данные в таблице после выполнения инструкций INSERT и UPDATE.

Следующие шаги

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

Добавление дополнительных адаптеров таблиц.Мастер создает только один адаптер таблиц.Если предполагается использовать набор данных, который содержит несколько таблиц, может потребоваться добавить еще несколько адаптеров таблиц в форму или компонент.
Добавление дополнительных запросов к адаптеру таблиц.Дополнительные сведения см. в разделе Практическое руководство. Создание запросов TableAdapter.
Просмотрите этот набор данных в Окно "Источники данных" и перетащите элементы в форму для создания элемента управления с привязкой к данным.Дополнительные сведения см. в разделе Привязка элементов управления Windows Forms к данным в Visual Studio.

См. также