|
The ADO Parameter Object represents a parameter or argument associated with a Command object based on a parameterized query or stored procedure.
All the Property objects for a specific instance of a Parameter object. This collection is not currently supported on UNIX. |
Appends data to a large text or binary data parameter. |
One or more characteristics of a parameter. This property is currently read-only on UNIX. | |
Indicates if the parameter is an input parameter, an output parameter, or both; or if the parameter is the output of a stored procedure. | |
The name of the parameter. | |
The scale of numeric values in the parameter. | |
The degree of precision for numeric values in the parameter. | |
The maximum size, in bytes or characters, of a parameter. | |
The data type of the parameter. | |
The value assigned to the parameter. |
The Properties collection is not currently supported on UNIX.
Many providers support parameterized commands. These are commands where the desired action is defined once, but variables (or parameters) are used to alter some details of the command. 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.
The 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.
The collections, methods, and properties of a Parameter object are used to:
· set or return the name of a parameter with the ADO Parameter Object Name Property.
· set or return the value of a parameter with the ADO Parameter Object Value Property.
· set or return parameter characteristics with the ADO Parameter Object Attributes Property, ADO Parameter Object Direction Property, ADO Parameter Object Precision Property, ADO Parameter Object NumericScale Property, ADO Parameter Object Size Property, and ADO Parameter Object Type Property properties.
· pass long binary or character data to a parameter with the ADO Parameter Object AppendChunk Method.
If you know the names and properties of the parameters associated with the stored procedure or parameterized query you wish to call, you can use the CreateParameter method to create Parameter objects with the appropriate property settings and use the ADO Collections Append Method to add them to the ADO Parameters Collection. This lets you set and return parameter values without having to call the ADO Collections Refresh Method on the Parameters collection to retrieve the parameter information from the provider, a potentially resource-intensive operation.
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Legal Notice.