Поделиться через

Практическое руководство. Настройка параметров для адаптеров обработки данных

  • Статья

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

В большинстве случаев объекты Command адаптера данных (SelectCommand, InsertCommand, UpdateCommand и DeleteCommand) ссылаются на инструкции SQL или хранимые процедуры, которым требуются параметры. Если при создании адаптера использован мастер настройки адаптера данных, параметры для этих команд настраиваются автоматически. Однако может возникнуть необходимость настроить параметры вручную или внести небольшие изменения в существующую коллекцию параметров.

30bys7z3.alert_note(ru-ru,VS.90).gifПримечание.

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

Для настройки параметров после внесения изменений в инструкцию SQL для команды выбирается параметр Создать коллекцию параметров для этой команды в построителе запросов.
30bys7z3.alert_note(ru-ru,VS.90).gifПримечание.

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

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

  1. Создайте адаптер данных. Подробные сведения содержатся в Создание адаптеров данных.

  2. В конструкторе формы или компонента выберите адаптер данных, а затем откройте окно "Свойства".

  3. Раскройте объект команды, для которого необходимо настроить параметры (например UpdateCommand), а затем в свойстве Parameters щелкните кнопку с многоточием (...), чтобы открыть окно Редактор коллекции параметров.

  4. Для создания нового объекта параметра щелкните Добавить.

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

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

    Свойство

    Описание

    SourceColumn

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

    SourceVersion

    Если значение параметра выводится с помощью свойства SourceColumn, SourceVersion указывает, какую из следующих версий записи набора данных необходимо использовать в качестве источника значения параметра:

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

    • Current — значение столбца после обновления записи. Обычно это значение, которое необходимо записать в базу данных.

    • Default — значение, установленное для столбца по умолчанию, если никакое другое значение явно не присвоено.

    Value

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

    Свойство Value имеет приоритет над свойством SourceColumn, если оба эти свойства установлены.

    NamedParameter

    Логическое значение, указывающее, соответствует ли параметр переменной (обычно с форматом @имя_параметра) или заполнителю (обычно знак вопроса). При работе с объектом SqlConnection и использовании именованных параметров установите значение true.

    DBType, Precision, Scale, Size

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

    Direction

    Определяет, передается ли значение параметра команде или обратно:

    • Input — значение передается команде. Это значение используется по умолчанию.

    • Output — значение передается обратно из хранимой процедуры. (Недействительно для инструкций SQL.)

    • InputOutput — значение передается в хранимую процедуру и обратно, обычно с измененным значением.

    • ReturnValue — значение является явным возвращаемым значением. По умолчанию возвращенное значение является первым элементом (нулевое значение индекса) в коллекции параметров.

    ParameterName

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

  7. Нажмите OK, чтобы закрыть окно Редактор коллекции параметров.

  8. Повторите шаги 3 – 7 для настройки параметров для других объектов команд.

См. также

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

Параметры команд адаптеров обработки данных