CreateParameter 方法 (ADO)CreateParameter Method (ADO)

创建具有指定属性的新 参数 对象。Creates a new Parameter object with the specified properties.

语法Syntax

  
Set parameter = command.CreateParameter (Name, Type, Direction, Size, Value)  

返回值Return Value

返回一个 参数 对象。Returns a Parameter object.

参数Parameters

名称Name
可选。Optional. 一个包含 参数 对象名称的 字符串 值。A String value that contains the name of the Parameter object.

类型Type
可选。Optional. 指定 参数 对象的数据类型的 DataTypeEnum值。A DataTypeEnum value that specifies the data type of the Parameter object.

方向Direction
可选。Optional. 指定 参数 对象类型的 ParameterDirectionEnum值。A ParameterDirectionEnum value that specifies the type of Parameter object.

大小Size
可选。Optional. 一个 长整型 值,指定参数值的最大长度(以字符或字节为单位)。A Long value that specifies the maximum length for the parameter value in characters or bytes.

Value
可选。Optional. 一个 变量 ,指定 参数 对象的值。A Variant that specifies the value for the Parameter object.

备注Remarks

使用 CreateParameter 方法创建一个具有指定名称、类型、方向、大小和值的新 参数 对象。Use the CreateParameter method to create a new Parameter object with a specified name, type, direction, size, and value. 您在参数中传递的任何值都将写入相应的 参数 属性。Any values you pass in the arguments are written to the corresponding Parameter properties.

此方法不会将 参数 对象自动追加到 Command对象的 Parameters 集合。This method does not automatically append the Parameter object to the Parameters collection of a Command object. 这使你可以设置其他属性,这些属性的值会在你将 参数 对象追加到集合时进行验证。This lets you set additional properties whose values ADO will validate when you append the Parameter object to the collection.

如果在 类型 参数中指定可变长度的数据类型,则必须在将其追加到 Parameters 集合之前传递 Size 参数或设置 参数 对象的 size属性;否则,将发生错误。If you specify a variable-length data type in the Type argument, you must either pass a Size argument or set the Size property of the Parameter object before appending it to the Parameters collection; otherwise, an error occurs.

如果在 类型 参数中指定数值数据类型 (adNumericadDecimal) ,则还必须设置 NumericScale精度属性。If you specify a numeric data type (adNumeric or adDecimal) in the Type argument, then you must also set the NumericScale and Precision properties.

应用于Applies To

命令对象 (ADO)Command Object (ADO)

另请参阅See Also

Append 和 CreateParameter 方法示例 (VB) Append and CreateParameter Methods Example (VB)
附加和 CreateParameter 方法示例 (VC + +) Append and CreateParameter Methods Example (VC++)
ADO (追加方法) Append Method (ADO)
参数对象 Parameter Object
参数集合 (ADO)Parameters Collection (ADO)