Редактор коллекции параметров

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

Позволяет создавать и настраивать параметры (OleDbParameter, SqlParameter, OdbcParameter и объекты OracleParameter), связанные с инструкциями SQL или хранимыми процедурами в адаптерах таблиц и адаптерах данных.

Правка коллекций параметров

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

Выделите адаптер таблиц в Конструкторе наборов данных и выберите свойство Параметры в окне Свойства, чтобы открыть Редактор коллекции параметров.

1. Откройте узел для свойств SelectCommand, UpdateCommand, InsertCommand и DeleteCommand.

2. Измените свойство Параметры, чтобы открыть Редактор коллекции параметров.

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

Имена параметров

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

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

Select * From Customers Where City = ?

Если используется объект SqlDataAdapter, то инструкция, использующая именованные параметры, может выглядеть следующим образом:

Select * From Customers Where City = @City

Если используется объект OracleDataAdapter, то инструкция, использующая именованные параметры, может выглядеть следующим образом:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID

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

Добавление параметров

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

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

• Свойство ParameterName, по которому можно ссылаться на параметр в коде.

  Примечание.
  Класс SqlDataAdapter требует именованные параметры, поэтому в объектах SqlParameter имя должно всегда начинаться с "@".

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

• Свойство SourceVersion, которое используется совместно со свойством SourceColumn. Если запись в наборе данных изменилась, становятся доступны несколько копий этой записи, включая исходное значение (прочитанное из источника данных) и текущее значение (после изменений). При указании значения столбца для передачи в качестве параметра необходимо выбрать, какое из двух значений передавать. Исходное значение обычно используется как параметр предложения WHERE для указания записи в базе данных, а текущее значение используется в предложениях SET и VALUES.

• Свойство Value, являющееся значением явного литерала, передаваемого в качестве параметра. Настройка этого свойства переопределяет свойство SourceColumn; эти два свойства являются взаимоисключающими.

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

Список элементов пользовательского интерфейса

• Добавить
  Создает новый параметр в коллекции. По умолчанию таблица получает имя Parametern, где n — это порядковый номер. Таблицу можно переименовать, изменив ее свойство ParameterName в таблице свойств.

  Примечание.
  Редактор коллекции OleDbParameter не проверяет правильность количества и типов параметров, созданных для команды.

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

• Удалить
  Удаляет выбранный параметр из коллекции.

См. также

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

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

Ссылки

SqlParameter

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

Адаптер таблицы

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

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

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

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

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

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

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