<html>
<head>
<title>Parameter Object </title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div id="Description">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">Parameter Object </td>
<td valign="top" class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description">
<p>
The Parameter object contains information for one variable within a
SQL statement or stored procedures. Combined, Parameter objects
belong to the Parameters collection of Command objects.</p></td></tr>
</table>
</div>
<div id="Parameter.AppendChunk">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.AppendChunk Method </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameter</span>.AppendChunk <span class="replaceable">Data</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The AppendChunk method appends data to a large data or binary field
within the current Parameter object.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Arguments</td>
</tr>
<tr>
<td colspan="2" class="description">


<dl>
<dt><span class="replaceable">Data</span></dt>
<dd><p>The only parameter, <span class="replaceable">Data</span>, is a Variant
datatype that contains the large amount of data that you wish to
append to the current Parameter object.</p></dd>

</dl>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The AppendChunk method appends large amounts of either text or binary
data to an existing Parameter object. This can be very useful when
the current system contains limited system memory in respect to the
amount needed for the operation to be performed. With the AppendChunk
method, you can add the data to your Field object in increments as
you see fit.</p>


<p>The <span class="LITERAL">adFldLong</span> bit of the Arguments property
belonging to the Parameter object must be set in order for the
AppendChunk method of the Parameter object to be called.</p>


<p>By calling the AppendChunk method multiple times on a Parameter
object, you append the data to the pre-existing data in the object.
The only way to clear the data in a Parameter object is set it to a
zero-length string. By passing a <span class="LITERAL">Null</span> value to the
AppendChunk method of a Parameter object, you generate an error.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">See Also</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Parameter.Arguments Property</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Attributes">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Attributes Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameter</span>.Attributes = <span class="replaceable">ParameterAttributesEnum</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Attributes property is used to set or return specific
characteristics about the Parameter object.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>ParameterAttributesEnum (Long)</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Arguments property is read- and write-enabled. The value of the
Arguments property can be set to any sum of the values from the
ParameterArgumentsEnum enumeration listed in <link linkend="ado-APP-E">Appendix E</link>. The default value for the Arguments property is
<span class="LITERAL">adParamSigned</span>.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">See Also</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>ParameterAttributesEnum Enumeration</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Direction">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Direction Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameter</span>.Direction = <span class="replaceable">ParameterDirectionEnum</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Direction property specifies whether the current parameter is an
input parameter, an output parameter, both an input and an output
parameter, or a return value from a stored procedure.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>ParameterDirectionEnum (Long)</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Direction property is both read- and write-enabled. It is to your
advantage to add parameters manually to a Parameters collection so
that ADO does not have to make additional calls to the data provider
to locate this information itself. In some cases, you must specify
the Direction property manually because the particular data provider
may not be able to determine this information itself.</p>


<p>The Direction property may be set to one of the
ParameterDirectionEnum enumerations listed in <link linkend="ado-APP-E">Appendix E</link>.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Note</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Not all providers can determine the value of the Direction property;
therefore, for such providers the application must manually set the
value of the Direction property for parameters before they are used.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">See Also</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>ParameterDirectionEnum Enumeration</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Name">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Name Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameter</span>.Name = <span class="replaceable">Name</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Name property specifies the name for the current Parameter object.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>String</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Name property is both read- and write-enabled for the Parameter
object. You can set the Name property only if the Parameter object is
not already appended to a Parameters collection.</p>


<p>The Name property assigns a name to the associated Parameter object
or retrieves a Parameter object from the Parameters collection.</p>


<p>Names do not have to be unique within the Parameters collection
object.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.NumericScale">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.NumericScale Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">numberscale = parameter</span>.NumericScale</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The NumericScale property indicates the scale of numeric values in
the current Parameter object.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Byte</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The NumericScale property is both read- and write-enabled for the
Parameter object. It is used to identify how many bytes are used to
the right of the decimal point for a numeric Parameter object.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Precision">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Precision Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">precision = parameter</span>.Precision</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Precision property represents the degree of precision of a
numeric value within the current Parameter object.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Byte</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Precision property is both read- and write-enabled for the
Parameter object. This property returns a Byte value that indicates
the total number of digits used to represent a value for a numeric
Parameter object.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Properties">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Properties Collection </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br>Set <span class="replaceable">properties = parameter</span>.Properties</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Properties collection returns a Properties collection class that
contains characteristics specific to the Parameter object for the
currently used provider.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Properties (Collection object)</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Properties collection class contains a Property class instance
for each property specific to the Parameter object for the data
provider.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Size">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Size Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameter</span>.Size = size</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Size property returns the maximum size of a Parameter
object's value.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Long</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Size property returns the maximum size of a parameter's
value, in bytes. This property is both read- and write-enabled.</p>


<p>If a Parameter object is of variable length datatype, the Size
property must be set before it is appended to the Parameters
collection, or an error will be generated.</p>


<p>If you attempt to change the datatype of a Parameter object to a
variable-length datatype, be sure to set the Size property first so
that an error will not be generated.</p>


<p>You should also set the Size property of the Parameter object before
calling the Execute method of the Command object, since if you
don't and a variable-length datatype exists, ADO may try to
allocate memory based on the maximum amount needed, causing an error.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Type">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Type Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameter</span>.Type = <span class="replaceable">DataTypeEnum</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Type property identifies the current object's datatype.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>DataTypeEnum (Long)</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Type property is both read- and write-enabled for the Parameter
object. This property returns a Byte value that indicates the total
number of digits used to represent a value for a numeric Parameter
object.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">See Also</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>DataTypeEnum Enumeration</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameter.Value">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameter.Value Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameter</span>.Value = <span class="replaceable">value</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Value property indicates the value assigned to the current
Parameter object.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Variant</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Value property reads and sets the value of the associated
Parameter object. The Value property supports long binary data
through ADO.</p>


<p>ADO reads Parameter objects' Value property only once. If you
execute a command containing a parameter with an empty Value
property -- and it creates a recordset -- be sure to close the
recordset before you read the Value property.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameters">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameters Collection</td>
<td class="COMPATIBILITY"><refpurpose/></td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br>Set <span class="replaceable">parameters  = command</span>.Parameters<br>Set <span class="replaceable">fields  = recordset</span>.Fields</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>See the Parameter Object for more information and examples pertaining
to the Parameters collection.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Objects</td>
</tr>
<tr>
<td colspan="2" class="description">


<dl>
<dt>Parameter</dt>
<dd><p>Contains information about a particular parameter belonging to a SQL
statement, query, or stored procedure.</p></dd>

</dl>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Methods</td>
</tr>
<tr>
<td colspan="2" class="description">


<dl>
<dt>Append</dt>
<dd><p>Appends a new Parameter object to the current Parameters collection
class.</p></dd>

</dl>


<dl>
<dt>Delete</dt>
<dd><p>Removes a Parameter object from the Parameters collection class.</p></dd>

</dl>


<dl>
<dt>Refresh</dt>
<dd><p>Updates the collection with the parameters of the current stored
procedure or parameterized query associated with the Command object
to which the Parameters collection belongs.</p></dd>

</dl>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Properties</td>
</tr>
<tr>
<td colspan="2" class="description">


<dl>
<dt>Count</dt>
<dd><p>Indicates how many Parameter objects belong to the associated
Parameters collection.</p></dd>

</dl>


<dl>
<dt>Item</dt>
<dd><p>Accesses a particular Parameter object belonging to the Parameters
collection.</p></dd>

</dl>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameters.Append">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameters.Append Method </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameters</span>.Append <span class="replaceable">Object</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Append method appends a new Parameter object to the current
Parameters collection class.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Arguments</td>
</tr>
<tr>
<td colspan="2" class="description">


<dl>
<dt><span class="replaceable">Object</span></dt>
<dd><p>The only parameter of the Append method is a Parameter object. The
Type property of the Parameter object must be set before the Append
method is actually called. In addition, if the datatype of your
Parameter is of variable length, you must also set the Size property
of the Parameter object to a value greater than zero.</p></dd>

</dl>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Append method of the Parameters collection informs ADO of the
type of parameters that are included in stored procedures or
parameterized queries. You would do this for a couple of reasons: one
is that it decreases the time that a stored procedure or
parameterized query takes to perform its duty by minimizing the calls
to the data provider for this information. Another reason for
declaring the parameters in advance -- by adding them to the
Parameters collection -- is that not all data providers actually
make this information known to ADO. For this reason, unless you
populate the Parameters collection yourself, you stand a strong
chance of not being able to use these stored procedures or queries at
all.</p>


<p>It is my advice (as well as Microsoft's) to always declare the
parameters of a stored procedure or parameterized query in advance
whenever possible, because you may not always be able to rely on the
information being available to ADO (and it can't hurt having
the extra speed advantage).</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">See Also</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Command.CreateParameter Method, Parameter.Size Property,
Parameter.Type Property</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameters.Count">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameters.Count Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">count = parameters</span>.Count</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Count property indicates how many Parameter objects belong to the
associated Parameters collection.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Long</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>If the value of the Count property is zero, there are no Parameter
objects within the associated Parameters collection. However,
Parameter objects that do belong to the associated Parameters
collection are indexed from <span class="LITERAL">0</span> to one less than the
value of the Count property.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameters.Delete">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameters.Delete Method </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br><span class="replaceable">parameters</span>.Delete <span class="replaceable">Index</span></td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Delete method removes a Parameter object from the Parameters
collection class.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Arguments</td>
</tr>
<tr>
<td colspan="2" class="description">


<dl>
<dt><span class="replaceable">Index</span></dt>
<dd><p>The <span class="replaceable">Index</span> parameter can be either the name
of the Parameter object to be removed or its ordinal position.</p></dd>

</dl>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Delete method of the Parameters collection class removes a
Parameter object from the collection. By passing either the name of a
valid Parameter object within the collection or its ordinal position,
the Delete method removes the specified Parameter object from the
associated Parameters collection class.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">See Also</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Parameter.Name Property</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameters.Item">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameters.Item Property </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br>Set <span class="replaceable">error = errors</span>.Item(<span class="replaceable">Index</span>)<br>Set <span class="replaceable">error = errors</span> (<span class="replaceable">Index</span>)</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Item property accesses a particular Parameter object belonging to
the Parameters collection.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Datatype</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Object</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The <span class="replaceable">Index</span> placeholder is a Variant
datatype that represents the ordinal position of a Parameter object
within the Parameters collection. If the Parameters collection does
not contain the item requested, an error is generated.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Note</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>Some languages do not support the Item property in its first syntax.
For these languages, use the second syntax, without the Item method
name.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
<div id="Parameters.Refresh">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr valign="top">
<td class="NAME">
Parameters.Refresh Method </td>
<td class="COMPATIBILITY">(Versions 2.0, 2.1, 2.5, 2.6)</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td class="usage" colspan="2"><br>parameters.Refresh</td></tr>
<tr><td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr><td colspan="2" class="description">


<p>The Refresh method of the Parameters collection class updates the
collection with the parameters of the current stored procedure or
parameterized query associated with the Command object to which the
Parameters collection belongs.</p>

</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Description</td>
</tr>
<tr>
<td colspan="2" class="description">


<p>The Refresh method updates the Parameters collection class with the
parameters of the associated Command object's stored procedure
or parameterized query.</p>


<p>If you attempt to access the Parameters collection class before
calling the Refresh method, it is automatically called by ADO.</p>


</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
</table>
</div>
</body>
</html>