Put_Value Method

Applies To

OraParamArray

Description

This command is used to insert values into the table parameter.

Arguments

[in] value	A Variant representing the value to insert.
in] index	An Integer representing the index value of the object.

Usage

OraParamArray.Put_Value(value, index)

Remarks

This method should be used to insert a value before accessing a row in a table. A row does not contain a valid value until a row is assigned a value. Any reference to an unassigned row in the table will raise "OLE Automation error".

The Value argument can be an Oracle8i object, such as an OraBLOB. For put_value a copy of the object is made at that point in time and get_value must be accessed to obtain a new object that refers to that index value. For example, if iotype is ORATYPE_BOTH and an OraBlob obtained from a dynaset is passed in as the input value, get_value will need to be called after the SQL has been executed so that the newly updated output value of the ParamaterArray can be obtained.

Similar to a dynaset, the object obtained from ParamaterArray get_value method always refers to the latest value for that ParamaterArray index. The Visual Basic value NULL can also be passed as a value. The Visual Basic value EMPTY can be used for BLOB and CLOB to mean an empty LOB, and for OBJECT, VARRAY and NESTED TABLE to mean an object whose attributes are all NULL.