ADO CreateParameter Method
The CreateParameter method creates and returns a Parameter object containing
the specified properties like name, type, direction, size, and value.
Note: This method does not automatically add the new Parameter to the
collection. To add the Parameter to the Parameters Collection, use the Append
property.
Syntax
Set objparameter=objcommand.CreateParameter
(name,type,direction,size,value)
|
Example:
|
Set objParameter =
objCommand.CreateParameter
objParameter.Name = "ConfirmID"
objParameter.Type = adBoolean
objParameter.Direction = adParamInput
objParameter.Value = True
Or:
Set objParameter =
objCommand.CreateParameter
("ConfirmID", adBoolean, adParamInput, True)
|
Example:
Dim cmd As
ADODB.Command
Dim prm As ADODB.Parameter
Set cmd = New ADODB.Command
With cmd
.ActiveConnection = CurrentProject.Connection
.CommandText = "qry_DeleteTable1"
.CommandType = adCmdStoredProc
Set prm = cmd.CreateParameter(Name:="ConfirmID",
Type:=adInteger, Direction:=adParamInput).Parameters.Append prm
prm.Value = 13
.Execute
End With |
| Parameter |
Description |
| name |
Optional. The name of the Parameter object. |
| type |
Optional. One of the
DataTypeEnum constants that specifies the data type for the
Parameter object. Default is adEmpty. If you choose a variable-length
data type, you will also need to specify the Size parameter or the Size
property. If you specify adDecimal or adNumeric data type, you must also
set the NumericScale and the Precision properties of the Parameter
object. |
| direction |
Optional. One of the
ParameterDirectionEnum constants that defines the direction of the
Parameter object. Default is adParamInput.
|
| size |
Optional. Specifies the length of a variable-length
data type, if such a type was declared in the Type parameter.
Default is zero. |
| value |
Optional. The value of the Parameter object |
DataTypeEnum Values
Specifies the data type of a Field, Parameter, or Property object
| Constant |
Value |
Description |
| adEmpty |
0 |
No value |
| adSmallInt |
2 |
A 2-byte signed integer. |
| adInteger |
3 |
A 4-byte signed integer. |
| adSingle |
4 |
A single-precision floating-point value. |
| adDouble |
5 |
A double-precision floating-point value. |
| adCurrency |
6 |
A currency value |
| adDate |
7 |
The number of days since December 30, 1899 + the
fraction of a day. |
| adBSTR |
8 |
A null-terminated character string. |
| adIDispatch |
9 |
A pointer to an IDispatch interface on a COM
object. Note: Currently not supported by ADO.
|
| adError |
10 |
A 32-bit error code |
| adBoolean |
11 |
A boolean value. |
| adVariant |
12 |
An Automation Variant. Note:
Currently not supported by ADO.
|
| adIUnknown |
13 |
A pointer to an IUnknown interface on a COM
object. Note: Currently not supported by ADO.
|
| adDecimal |
14 |
An exact numeric value with a fixed precision and scale. |
| adTinyInt |
16 |
A 1-byte signed integer. |
| adUnsignedTinyInt |
17 |
A 1-byte unsigned integer. |
| adUnsignedSmallInt |
18 |
A 2-byte unsigned integer. |
| adUnsignedInt |
19 |
A 4-byte unsigned integer. |
| adBigInt |
20 |
An 8-byte signed integer. |
| adUnsignedBigInt |
21 |
An 8-byte unsigned integer. |
| adFileTime |
64 |
The number of 100-nanosecond intervals since January
1,1601 |
| adGUID |
72 |
A globally unique identifier (GUID) |
| adBinary |
128 |
A binary value. |
| adChar |
129 |
A string value. |
| adWChar |
130 |
A null-terminated Unicode character string. |
| adNumeric |
131 |
An exact numeric value with a fixed precision and scale. |
| adUserDefined |
132 |
A user-defined variable. |
| adDBDate |
133 |
A date value (yyyymmdd). |
| adDBTime |
134 |
A time value (hhmmss). |
| adDBTimeStamp |
135 |
A date/time stamp (yyyymmddhhmmss plus a fraction in
billionths). |
| adChapter |
136 |
A 4-byte chapter value that identifies rows in a child
rowset |
| adPropVariant |
138 |
An Automation PROPVARIANT. |
| adVarNumeric |
139 |
A numeric value (Parameter object only). |
| adVarChar |
200 |
A string value (Parameter object only). |
| adLongVarChar |
201 |
A long string value. |
| adVarWChar |
202 |
A null-terminated Unicode character string. |
| adLongVarWChar |
203 |
A long null-terminated Unicode string value. |
| adVarBinary |
204 |
A binary value (Parameter object only). |
| adLongVarBinary |
205 |
A long binary value. |
| AdArray |
0x2000 |
A flag value combined with another data type constant. Indicates an
array of that other data type. |
Specifies whether the Parameter represents an input parameter, an output
parameter, both an input and an output parameter, or the return
value from a
stored procedure.
| Constant |
Value |
Description |
| adParamUnknown |
0 |
Direction is unknown |
| adParamInput |
1 |
Input parameter |
| adParamOutput |
2 |
Output parameter |
| adParamInputOutput |
3 |
Both input and output parameter |
| adParamReturnValue |
4 |
Return value |
|