Put_Valueメソッド

適用対象

説明

表のパラメータに値を挿入します。

使用方法

OraParamArray.Put_Value(value, index)

引数

このメソッドの引数は、次のとおりです。

引数	説明
[`in`] `value`	挿入する値を表す`Variant`。
[`in`] `index`	オブジェクトの索引値を表す整数。

備考

表の行にアクセスする前に値を挿入するには、このメソッドを使用してください。行に値を割り当てるまで、行には有効な値が含まれません。表内の未割当ての行を参照すると、OLEオートメーション・エラーが発生します。

value引数には、OraBLOBなどのOracle Database 10gオブジェクトを使用できます。Put_Valueでは、その時点でオブジェクトのコピーが作成されるので、そのインデックス値を参照する新規オブジェクトを取得するためにGet_Valueにアクセスする必要があります。たとえば、iotypeがORATYPE_BOTHで、ダイナセットから取得したOraBLOBが入力値として渡される場合、新たに更新されたParamaterArrayの出力値を取得するためには、SQLが実行された後にGet_Valueをコールする必要があります。

ダイナセットと同様に、ParamaterArrayのGet_Valueメソッドから取得したオブジェクトは、常に、そのParamaterArrayの索引について最新の値を参照します。Visual BasicのNULL値を値として渡すこともできます。Visual Basicの値EMPTYは、BLOBおよびCLOBに対しては空のLOBを意味する目的で、OBJECT、VARRAYおよびNESTED TABLEに対しては、オブジェクトの属性がすべてNULLであることを意味する目的で使用できます。

RAW型の列(ServerTypeがORATYPE_RAW_BIN)にバインドする場合、値はバイト配列である必要があります。