構文

object.AppendChunk Data

パラメータ

説明

AppendChunk メソッドを使って、Field オブジェクトまたは Parameter オブジェクトに長バイナリまたは文字データを格納します。システムのメモリに制限がある場合、AppendChunk メソッドを使うと、長い値をいくつかのセグメントに分けて操作できます。

Parameter オブジェクトの Attributes プロパティで adFldLong ビットが True (1) に設定されている場合、その Parameter オブジェクトに AppendChunk メソッドを使用することができます。

Parameter オブジェクトで AppendChunk メソッドを最初に呼び出したときは、パラメータの既存データに上書きしてデータが書き込まれます。Parameter オブジェクトで AppendChunk メソッドを続けて呼び出したときは、既存のパラメータ データに追加されます。AppendChunk メソッドの呼び出しで Null 値を渡すと、すべてのパラメータ データが破棄されます。

構文

object.Value

パラメータ

設定値と戻り値

オブジェクトの値を表すバリアント型 (Variant) の値を設定します。また、値の取得も可能です。既定値は、Type プロパティの設定によって異なります。

説明

Parameter オブジェクトでパラメータ値を設定または取得するときは、Value プロパティを使います。Value プロパティは、状況に応じて読み取り/書き込み可能になったり、読み取り専用になります。詳細については、関連するオブジェクトのトピックを参照してください。

ADO では、Value プロパティを使って長バイナリ型 (Long Binary) データを設定したり、返すことができます。

注意 Parameter オブジェクトの場合、ADO は、プロバイダから一度だけ Value プロパティを読み取ります。コマンドに Value プロパティが空の Parameter があり、そのコマンドから Recordset を作成する場合は、Value プロパティを取得する前に必ず Recordset を閉じてください。そうしないと、プロバイダによっては Value プロパティが空になり、正しい値が設定されないことがあります。

構文

object.Type

パラメータ

設定値と戻り値

DataTypeEnum 値を設定します。また、値の取得も可能です。

説明

Parameter オブジェクトでは、Type プロパティは読み取り/書き込み可能です。

構文

object.Size

パラメータ

設定値と戻り値

Parameter オブジェクトの最大サイズをバイト数または文字数で示す、長整数型 (Long) の値を設定します。また、値の取得も可能です。

説明

Parameter オブジェクトの Value プロパティに対して書き取り/読み取り可能な値の最大値を調べるには、Size プロパティを使います。

Parameter オブジェクトで可変長データ型 (たとえば adVarChar などのすべての文字列型 (String)) を指定した場合、Parameters コレクションにそれを追加する前にオブジェクトの Size プロパティを設定する必要があります。この設定が行われていない場合は、エラーが発生します。

Command オブジェクトの Parameters コレクションに既に Parameter オブジェクトが追加されている場合、そのデータ型を可変長データ型に変更するためには、Command オブジェクトを実行する前に Parameter オブジェクトの Size プロパティを設定する必要があります。この設定が行われていない場合は、エラーが発生します。

Refresh メソッドを実行してプロバイダからパラメータ情報を取得したときに、1 つ以上の可変長データ型の Parameter オブジェクトが返された場合、パラメータサイズの上限を基にメモリがパラメータに割り当てられます。実行時にこの操作が行われると、エラーが発生します。エラーを避けるには、コマンドの実行前に、これらのパラメータの Size プロパティを明示的に設定しておきます。

Size プロパティは読み取り/書き込み可能です。

構文

object.Precision

パラメータ

設定値と戻り値

値を表す場合の最大桁数を示すバイト型 (Byte) の値を設定します。また、値の取得も可能です。

説明

数値型の Parameter オブジェクトで使用される数値の最大桁数を指定するには、Precision プロパティを使います。

Parameter オブジェクトでは、値は読み取り/書き込み可能です。

構文

object.NumericScale

パラメータ

設定値と戻り値

数値を処理するときの小数点以下の桁数を示す Byte 値を設定します。また、値の取得も可能です。

説明

数値型の Parameter オブジェクトの値の小数点以下の桁数は、NumericScale プロパティを使って指定します。

Parameter オブジェクトでは、NumericScale プロパティは読み取り/書き込み可能になっています。

構文

object.Name

パラメータ

設定値と戻り値

オブジェクトの名前を示す文字列型 (String) の値を設定します。また、値の取得も可能です。

説明

Parameter オブジェクト名を設定または取得します。

Parameters コレクションに追加されていない Parameter オブジェクトでは、Name プロパティの属性は読み取り/書き込み可能になっています。追加された Parameter オブジェクトとその他のオブジェクトでは、Name プロパティは読み取り専用です。名前はコレクション内で一意でなくてもかまいません。

オブジェクトの Name プロパティは、その序数参照で取得することができ、その後は、その名前で直接オブジェクトを参照できます。たとえば、 rstMain.Properties(20).Name で Updatability を取得すると、次からはこのプロパティを rstMain.Properties(“Updatability”) で参照できます。

構文

object.Direction = value

パラメータ

設定値と戻り値

ParameterDirectionEnum の値を設定します。また、値の取得も可能です。

説明

プロシージャとのパラメータのやり取りの方法を指定するには、Direction プロパティを使います。Direction プロパティは読み取り/書き込み可能になっています。そのため、この情報を返したり、指定できないプロバイダを使用するときでも、パラメータ情報の取得のために ADO がそれ以上プロバイダを呼び出さないようにすることができます。

プロバイダの中には、ストアド プロシージャのパラメータの入出力の方向を確認できないものがあります。この場合は、クエリを実行する前に Direction プロパティを設定します。

構文

object.Attributes = value

パラメータ

設定値と戻り値

長整数型 (Long) の値を設定します。また、値の取得も可能です。

Attributes プロパティは 1 つ以上の FieldAttributeEnum 値の和になります。通常は読み取り専用ですが、Record の Fields コレクションに追加された新規 Field オブジェクトの場合、Field の Value プロパティが指定されていて、データ プロバイダが Fields コレクションの Update メソッドを呼び出して新規 Field の追加に成功した場合に限り、Attributes は読み取り/書き込み可能になります。

説明

Parameter オブジェクトの場合、Attributes プロパティは読み取り/書き込み可能で、その値は 1 つ以上の ParameterAttributesEnum 値の和になります。既定値は adParamSigned です。

Property オブジェクトの場合、Attributes プロパティは読み取り専用で、その値は、1 つ以上の PropertyAttributesEnum 値の和になります。