Attributes プロパティ

オブジェクトが持つ 1 つまたは複数の特性を示します。

設定値と戻り値

長整数型 (Long) の値を設定または取得します。

Connection オブジェクトの Attributes プロパティの値は、次の XactAttributeEnum 値の 1 つ以上の値の合計になります (デフォルトは 0 です)。

定数

説明

adXactCommitRetaining

131072

保留中のコミット処理を実行します。つまり、CommitTrans 呼び出しによって自動的に新しいトランザクションが開始します。すべてのプロバイダがこの機能をサポートするわけではありません。

adXactAbortRetaining

262144

保留中の中断処理を実行します。つまり、RollbackTrans 呼び出しによって自動的に新しいトランザクションが開始します。すべてのプロバイダがこの機能をサポートするわけではありません。

Parameter オブジェクトの Attributes プロパティの値は、次の ParameterAttributesEnum 値の 1 つ以上の値の合計になります。

定数

説明

adParamSigned

16

パラメータが符号付きの値を受け取ることを示します (デフォルト)。

adParamNullable

64

パラメータが Null 値を受け取ることを示します。

adParamLong

128

パラメータがロング バイナリ型のデータを受け取ることを示します。

Field オブジェクトの Attributes プロパティの値は、フィールドの特性を指定するもので、次の FieldAttributeEnum 値の 1 つ以上の値の合計になります。

定数

説明

adFldMayDefer

2

フィールドの取得が遅滞することを示します。つまり、レコード全体を持つデータ ソースから取得することはできず、フィールドに明示的にアクセスしたときだけフィールド値が取得されます。

adFldUpdatable

4

フィールドへの書き込みが可能であることを示します。

adFldUnknownUpdatable

8

フィールドへの書き込みが可能かどうかをプロバイダが判定できないことを示します。

adFldFixed

16

フィールドに固定長データが含まれていることを示します。

adFldIsNullable

32

フィールドが Null 値を受け取ることを示します。

adFldMayBeNull

64

フィールドから Null 値を読み取ることができることを示します。

adFldLong

128

フィールドがロング バイナリ型のフィールドであることを示します。また、AppendChunk メソッドおよび GetChunk メソッドを使用できることを示します。

adFldRowID

256

フィールドにレコード ID に相当する情報 (レコード番号や一意な識別子など) が含まれていることを示します。

adFldRowVersion

512

フィールドに時刻または日付のタイム スタンプに相当する情報 (更新の記録に使用するもの) が含まれていることを示します。

adFldCacheDeferred

4096

プロバイダがフィールド値をキャッシュして、以降の読み取りがキャッシュから行われることを示します。

Property オブジェクトの Attributes プロパティの値は、次の PropertyAttributesEnum 値の 1 つ以上の値の合計になります。

定数

説明

adPropNotSupported

0

プロバイダがこのプロパティをサポートしていないことを示します。

adPropRequired

1

データ ソースを初期化する前に、ユーザーがこのプロパティの値を指定しなければならないことを示します。

adPropOptional

2

データ ソースを初期化する前に、ユーザーは必ずしもこのプロパティの値を指定する必要がないことを示します。

adPropRead

512

ユーザーがプロパティを読み取ることができることを示します。

adPropWrite

1024

ユーザーがプロパティを設定することができることを示します。

解説

Attributes プロパティは、ConnectionParameterFieldProperty の各オブジェクトの特性の設定または取得のために使います。

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

Parameter オブジェクトの Attributes プロパティは、読み取り/書き込みが可能です。 Field オブジェクトおよび Property オブジェクトの Attributes プロパティは、読み取り専用です。

複数の属性を設定する場合は、対応する定数の和を指定できます。互いに矛盾する定数どうしの和をプロパティ値に設定した場合は、エラーになります。

対象

ConnectionFieldParameterProperty

関連項目

AppendChunkBeginTransCommitTransRollbackTransGetChunk