ADO CreateParameter 方法
定义和用法
CreateParameter 方法可创建和返回一个 Parameter 对象,该对象包含指定的属性,比如名称、类型、方向、大小和值。
注释:此方法不会将 Parameter 对象自动追加到 Command 对象的 Parameters 集合。如需向 Parameters 集合添加 Parameter 对象,请使用 Append 属性。
语法
Set objparameter=objcommand.CreateParameter (name,type,direction,size,value)
参数 | 描述 |
---|---|
name | 可选。Parameter 对象的名称。 |
type | 可选。DataTypeEnum 常量之一,指定 Parameter 对象的数据类型。默认是 adEmpty。如果你选择可变长度的数据类型,则需要规定 Size 参数或 Size 属性。如果规定 adDecimal 或者 adNumeric 数据类型,则必须设置 Parameter 对象的NumericScale 和 Precision 属性。 |
direction | 可选。ParameterDirectionEnum 常量之一,定义 Parameter 对象的方向。默认是 adParamInput。 |
size | 可选。规定可变数据类型的长度,假如此类类型被声明于 Type 参数中。默认是 0。 |
value | 可选。Parameter 对象的值。 |
DataTypeEnum 值
规定 Field, Parameter 或 Property 对象的数据类型:
常量 | 值 | 描述 |
---|---|---|
adEmpty | 0 | 没有值 (DBTYPE_EMPTY)。 |
adSmallInt | 2 | 一个双字节的有符号整数 (DBTYPE_I2)。 |
adInteger | 3 | 一个四字节的有符号整数 (DBTYPE_I4)。 |
adSingle | 4 | 一个单精度浮点值 (DBTYPE_R4)。 |
adDouble | 5 | 一个双精度浮点值 (DBTYPE_R8)。 |
adCurrency | 6 | 一个货币值 (DBTYPE_CY)。货币是一个定点数字,小数点右侧有四位数字。该值存储为八字节、范围为 10,000 的有符号整数。 |
adDate | 7 | 日期值 (DBTYPE_DATE)。日期保存为双精度数,数字的整数部分是从 1899 年 12 月 30 日算起的天数,小数部分是一天当中的片段时间。 |
adBSTR | 8 | 以 Null 终止的字符串 (Unicode) (DBTYPE_BSTR)。 |
adIDispatch | 9 |
指向 COM 对象上 IDispatch 接口的指针 (DBTYPE_IDISPATCH)。 注意:ADO 目前不支持这种数据类型。使用它可能导致不可预料的结果。 |
adError | 10 | 一个 32 位的错误代码 (DBTYPE_ERROR)。 |
adBoolean | 11 | 一个布尔值 (DBTYPE_BOOL)。 |
adVariant | 12 |
一个 Automation Variant (DBTYPE_VARIANT)。 注意:ADO 目前不支持这种数据类型。使用它可能导致不可预料的结果。 |
adIUnknown | 13 |
指向 COM 对象上 IUnknown 接口的指针 (DBTYPE_IUNKNOWN)。 注意:ADO 目前不支持这种数据类型。使用它可能导致不可预料的结果。 |
adDecimal | 14 | 具有固定精度和范围的确切数字值 (DBTYPE_DECIMAL)。 |
adTinyInt | 16 | 一个单字节的有符号整数 (DBTYPE_I1)。 |
adUnsignedTinyInt | 17 | 一个单字节的无符号整数 (DBTYPE_UI1)。 |
adUnsignedSmallInt | 18 | 一个双字节的无符号整数 (DBTYPE_UI2)。 |
adUnsignedInt | 19 | 一个四字节的无符号整数 (DBTYPE_UI4)。 |
adBigInt | 20 | 一个八字节的有符号整数 (DBTYPE_I8)。 |
adUnsignedBigInt | 21 | 一个八字节的无符号整数 (DBTYPE_UI8)。 |
adFileTime | 64 | 一个 64 位的值,表示从 1601 年 1 月 1 日开始的 100 个十亿分之一秒间隔的数量 (DBTYPE_FILETIME)。 |
adGUID | 72 | 全局唯一标识符 (GUID) (DBTYPE_GUID)。 |
adBinary | 128 | 一个二进制值 (DBTYPE_BYTES)。 |
adChar | 129 | 一个字符串值 (DBTYPE_STR)。. |
adWChar | 130 | 一个以 Null 终止的 Unicode 字符串 (DBTYPE_WSTR)。 |
adNumeric | 131 | 具有固定精度和范围的确切数字值 (DBTYPE_NUMERIC)。 |
adUserDefined | 132 | 一个用户定义的变量 (DBTYPE_UDT)。 |
adDBDate | 133 | 日期值 (yyyymmdd) (DBTYPE_DBDATE)。 |
adDBTime | 134 | 时间值 (hhmmss) (DBTYPE_DBTIME)。 |
adDBTimeStamp | 135 | 日期/时间戳(yyyymmddhhmmss 加十亿分之一的小数)(DBTYPE_DBTIMESTAMP)。 |
adChapter | 136 | 一个四字节的子集值,标识子行集合中的行 (DBTYPE_HCHAPTER)。 |
adPropVariant | 138 | 一个 Automation PROPVARIANT (DBTYPE_PROP_VARIANT)。 |
adVarNumeric | 139 | 一个数字值(仅限于 Parameter 对象)。 |
adVarChar | 200 | 一个字符串值(仅限于 Parameter 对象)。 |
adLongVarChar | 201 | 一个长字符串值(仅限于 Parameter 对象)。 |
adVarWChar | 202 | 一个以 Null 终止的 Unicode 字符串(仅限于 Parameter 对象)。 |
adLongVarWChar | 203 | 一个以 Null 终止的长 Unicode 字符串值(仅限于 Parameter 对象)。 |
adVarBinary | 204 | 一个二进制值(仅限于 Parameter 对象)。 |
adLongVarBinary | 205 | 一个长二进制值(仅限于 Parameter 对象)。 |
AdArray | 0x2000 | 一个标志值,通常与另一个数据类型常量组合,指示该数据类型的数组。 |
ParameterDirectionEnum 值
指定 Parameter 所表示的是输入参数、输出参数、既是输出又是输入参数,还是存储过程返回的值。
常量 | 值 | 描述 |
---|---|---|
adParamUnknown | 0 | 指示该参数的方向未知。 |
adParamInput | 1 | 默认值。指示该参数是输入参数 |
adParamOutput | 2 | 指示该参数是输出参数。 |
adParamInputOutput | 3 | 指示该参数既是输入参数,又是输出参数。 |
adParamReturnValue | 4 | 指示该参数是返回值。 |