Редактор коллекции параметров
Позволяет создавать и настраивать параметры (OleDbParameter, SqlParameter, OdbcParameter и объекты OracleParameter), связанные с инструкциями SQL или хранимыми процедурами в адаптерах таблиц и адаптерах данных.
Правка коллекций параметров
Редактор коллекции параметров отображается при использовании окна Свойства для настройки адаптера таблиц в конструктор наборов данных или адаптера данных на форме или компоненте.
Выделите адаптер таблиц в Конструкторе наборов данных и выберите свойство Параметры в окне Свойства, чтобы открыть Редактор коллекции параметров.
Откройте узел для свойств SelectCommand, UpdateCommand, InsertCommand и DeleteCommand.
Измените свойство Параметры, чтобы открыть Редактор коллекции параметров.
Примечание
Если для настройки адаптеров данных используются такие средства разработки, как мастер настройки адаптера таблицы или Мастер настройки параметров адаптера данных, то параметры адаптера настраиваются автоматически.
Именование параметров
Инструкции или сохраненные процедуры в этих командах могут быть определены замещающими символами параметра.
Если используется объект 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 не проверяет правильность количества и типов параметров, созданных для команды.
Параметры соответствуют заменяющим символам параметров в инструкциях или командах по позиции. Поэтому необходимо убедиться, что параметры в коллекции указаны в правильном порядке.
Удалить
Удаляет выбранный параметр из коллекции.
См. также
Ссылки
Основные понятия
Привязка элементов управления Windows Forms к данным в Visual Studio
Привязка элементов управления к данным в Visual Studio
Другие ресурсы
Подключение к данным в Visual Studio
Подготовка приложения к получению данных