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

Статья
09/13/2015

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

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

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

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

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

Выберите существующее подключение из списка подключений или щелкните Создать подключение, чтобы создать подключение к базе данных.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

На странице Создание хранимых процедур введите инструкцию SQL, заполняющую таблицу данных. Это будет инструкция SELECT адаптера таблицы и основа для создания хранимых процедур для выбора, обновления, вставки и удаления данных.
На странице Создание хранимых процедур выполните следующие действия.
1. Введите имя новой хранимой процедуры.
2. Укажите, требуется ли создавать хранимую процедуру в основной базе данных.
  
  Примечание
  
  Возможность создания хранимых процедур в базе данных определяется параметрами безопасности и разрешениями, установленными для этой конкретной базы данных.Например, если у вас нет разрешения на создание новых хранимых процедур в базе данных, этот параметр использовать нельзя.
Страница Просмотр результатов работы мастера показывает результаты создания адаптера таблицы. Если мастер сталкивается с проблемами, на этой странице выводятся сведения об ошибке.

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

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

Привязка команд к хранимым процедурам

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

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

Примечание

Хранимая процедура, назначенная команде 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.

См. также