Пошаговое руководство. Создание и настройка адаптеров обработки данных вручную

Статья
11/05/2008

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

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

Примечание.
В предыдущей версии Visual Studio адаптеры обработки данных использовались для связи между приложением и базой данных. Хотя адаптеры обработки данных по-прежнему являются основным компонентом Поставщики данных .NET Framework (ADO.NET), создаваемые с помощью конструктора адаптеры таблиц упрощают процесс перемещения данных между приложением и базой данных. Дополнительные сведения по работе с адаптерами таблиц TableAdapter содержатся в разделе Общие сведения об адаптере таблиц.

В предыдущей версии Visual Studio адаптеры обработки данных использовались для связи между приложением и базой данных. Хотя адаптеры обработки данных по-прежнему являются основным компонентом Поставщики данных .NET Framework (ADO.NET), создаваемые с помощью конструктора адаптеры таблиц упрощают процесс перемещения данных между приложением и базой данных. Дополнительные сведения по работе с адаптерами таблиц TableAdapter содержатся в разделе Общие сведения об адаптере таблиц.

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

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

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

Чтобы добавить адаптеры обработки данных, подключения и команды на панель элементов

Щелкните правой кнопкой мыши Панель элементов и выберите Выбрать элементы.
Выберите элементы, которые требуется добавить, из вкладки Компоненты .NET Framework диалогового окна Выбор элементов панели элементов. Например, чтобы использовать Поставщик данных платформы .NET Framework для SQL Server, выберите SqlDataAdapter, SqlConnection и SqlCommand.
Нажмите кнопку OK для добавления выбранных элементов на Панель элементов.

Для создания адаптера обработки данных вручную выполните следующие действия.

Убедитесь, что объект подключения доступен для формы или компонента, с которыми ведется работа. Сведения о добавлении автономного подключения содержатся в разделе Установка соединения (ADO.NET).
С вкладки Данные из Панели элементов перетащите объект OleDbDataAdapter, SqlDataAdapter ,OdbcDataAdapter или OracleDataAdapter на поверхность конструктора.

Конструктор добавляет экземпляр адаптера к форме или компоненту и запускает Мастер настройки адаптера данных.
Закройте мастер.

Для настройки адаптера обработки данных вручную выполните следующие действия.

Выберите адаптер, а затем в окне Свойства настройте команды, используемые для чтения и обновления данных. Необходимо настроить объект SelectCommand. Если адаптер будет использоваться для обновления источника данных, необходимо также настроить объекты UpdateCommand, DeleteCommand и InsertCommand.

Для каждого объекта команды установите следующие свойства.

Свойство	Описание
ActiveConnection	Ссылка на объект подключения. Имеется возможность создать объект подключения из свойства ActiveConnection в окне Свойства. Обычно каждый объект команды ссылается на объект подключения с тем же именем, но есть возможность использования разных подключений для каждой команды для тех случаев, когда это необходимо.
CommandText	Текст инструкции SQL или имя хранимой процедуры. Некоторые поставщики предоставляют возможность включать несколько инструкций или имен хранимых процедур в свойство CommandText, отделяя их точкой с запятой (;). Инструкции или процедуры выполняются последовательно. Это удобно в ситуациях, когда необходимо задать инструкцию SELECT после инструкций UPDATE или INSERT для возврата обновленных записей и любых автоматически созданных значений (например, значений по умолчанию или автоматически увеличенных значений).
CommandType	Значение, указывающее, как необходимо интерпретировать значение свойства CommandText: Text — команда является инструкцией SQL. StoredProcedure — команда является ссылкой на хранимую процедуру. TableDirect — текст является не командой, а именем таблицы.
Параметры	Коллекция объектов типа Parameter, настраиваемая для передачи значений команде. В объекте SelectCommand создается коллекция параметров только в том случае, если команда содержит "заполнитель" параметра. Объекты UpdateCommand, InsertCommand и DeleteCommand всегда требуют параметры. Дополнительные сведения см. в разделе Практическое руководство. Настройка параметров для адаптеров обработки данных.

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

В меню Данные выберите Создать набор данных.

Совет.
Если меню Данные не отображено, щелкните в любом месте конструктора формы или компонента; меню появляется, только если фокус переведен на конструктор.

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