Объект ParameterParameter Object

Представляет параметр или аргумент, связанный с объектом Command на основе параметризованного запроса или хранимой процедуры.Represents a parameter or argument associated with a Command object based on a parameterized query or stored procedure.

RemarksRemarks

Многие поставщики поддерживают параметризованные команды.Many providers support parameterized commands. Это команды, в которых нужное действие определено один раз, но переменные (или параметры) используются для изменения некоторых сведений о команде.These are commands in which the desired action is defined once, but variables (or parameters) are used to alter some details of the command. Например, инструкция SQL SELECT может использовать параметр для определения критерия сопоставления предложения WHERE, а другой — для определения имени столбца для предложения сортировки по.For example, an SQL SELECT statement could use a parameter to define the matching criteria of a WHERE clause, and another to define the column name for a SORT BY clause.

Объекты параметров представляют параметры, связанные с параметризованными запросами, а также входные и выходные аргументы и возвращаемые значения хранимых процедур.Parameter objects represent parameters associated with parameterized queries, or the in/out arguments and the return values of stored procedures. В зависимости от функциональных возможностей поставщика некоторые коллекции, методы или свойства объекта параметров могут быть недоступны.Depending on the functionality of the provider, some collections, methods, or properties of a Parameter object may not be available.

С помощью коллекций, методов и свойств объекта Parameter можно выполнять следующие действия.With the collections, methods, and properties of a Parameter object, you can do the following:

  • Задайте или верните имя параметра с помощью свойства Name .Set or return the name of a parameter with the Name property.

  • Задайте или верните значение параметра со свойством value .Set or return the value of a parameter with the Value property. Значение является свойством по умолчанию для объекта Parameter .Value is the default property of the Parameter object.

  • Установка или возврат характеристик параметров с помощью свойств Attributes, Direction, Precision, NumericScale, sizeи Type .Set or return parameter characteristics with the Attributes, Direction, Precision, NumericScale, Size, and Type properties.

  • Передайте длинные двоичные или символьные данные в параметр с помощью метода AppendChunk .Pass long binary or character data to a parameter with the AppendChunk method.

  • Доступ к атрибутам, зависящим от поставщика, с помощью коллекции Properties .Access provider-specific attributes by using the Properties collection.

Если вы знакомы с именами и свойствами параметров, связанных с хранимой процедурой или параметризованным запросом, который необходимо вызвать, можно использовать метод CreateParameter для создания объектов параметров с соответствующими параметрами свойств и использовать метод append для их добавления в коллекцию Parameters .If you know the names and properties of the parameters associated with the stored procedure or parameterized query you want to call, you can use the CreateParameter method to create Parameter objects with the appropriate property settings and use the Append method to add them to the Parameters collection. Это позволяет задавать и возвращать значения параметров без вызова метода Refresh в коллекции Parameters для получения сведений о параметрах от поставщика, потенциально требовательных к ресурсам операций.This lets you set and return parameter values without having to call the Refresh method on the Parameters collection to retrieve the parameter information from the provider, a potentially resource-intensive operation.

Объект параметра не является надежным для скриптов.The Parameter object is not safe for scripting.

Этот раздел содержит следующий раздел.This section contains the following topic.

См. такжеSee Also

Объект Command (ADO) Command Object (ADO)
Метод CreateParameter (ADO) CreateParameter Method (ADO)
Коллекция Parameters (ADO) Parameters Collection (ADO)
Коллекция Properties (ADO)Properties Collection (ADO)