サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
OriginalValue — 変更が行われる前のレコードの Field 値を示します。

構文

object.OriginalValue

パラメータ

戻り値

変更前のフィールドの値をバリアント型 (Variant) の値で返します。

説明

カレント レコードからフィールドの元の値を返すには、OriginalValue プロパティを使います。

” 即時更新モード” (プロバイダが Update メソッドの呼び出し後に、基になるデータ ソースに対して変更を書き込むモード) では、OriginalValue プロパティは、変更前 (最後の Update メソッドの呼び出し以後) のフィールド値を返します。この値は、Value プロパティを置き換えるために CancelUpdate メソッドが使用する値と同じです。

” バッチ更新モード” (プロバイダが複数の変更をキャッシュし、UpdateBatch メソッドが呼び出されたときにだけ基になるデータソースに書き込むモード) では、OriginalValue プロパティは、変更前 (最後の UpdateBatch メソッドの呼び出し以後) のフィールド値を返します。この値は、Value プロパティを置き換えるために CancelBatch メソッドが使用する値と同じです。UnderlyingValue プロパティと共にこのプロパティを使用すると、バッチ更新で発生する競合を解決することができます。

Recordについて

Record オブジェクトの場合、Update の呼び出し前に追加されたフィールドの OriginalValue プロパティは空になります。

(PWS4 IIS4 IIS5)
NumericScale — Field オブジェクトで、数値型 (Numeric) の値の桁数を示します。

構文

object.NumericScale

パラメータ

設定値と戻り値

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

説明

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

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

(PWS4 IIS4 IIS5)
Name — オブジェクトの名前を示します。

構文

object.Name

パラメータ

設定値と戻り値

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

説明

Name プロパティを使ってField オブジェクト名を設定または取得します。

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

(PWS4 IIS4 IIS5)
DefinedSize — Field オブジェクトのデータ容量を示します。

構文

object.DefinedSize

パラメータ

戻り値

バイト数でフィールドの定義サイズを反映する長整数型 (Long) の値を返します。

説明

Field オブジェクトのデータ許容量を調べるには、DefinedSize プロパティを使います。

DefinedSize プロパティと ActualSize プロパティは異なるものです。たとえば、宣言タイプが adVarChar で DefinedSize プロパティ値が 50 で、1 文字を格納した Field オブジェクトがあるとします。このオブジェクトが返す ActualSize プロパティ値は、1 文字をバイト数で表した長さです。

(PWS4 IIS4 IIS5)
Attributes — オブジェクトの 1 つ以上の特性を示します。

構文

object.Attributes

パラメータ

設定値と戻り値

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

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

説明

Field オブジェクトの特性の設定と取得には、Attributes プロパティを使います。

複数の属性を設定する場合、該当する定数の和を設定することができます。同時に設定できない定数の和をプロパティ値に設定すると、エラーが発生します。

(PWS4 IIS4 IIS5)
ActualSize — フィールド値の実際の長さを示します。

構文

object.ActualSize

パラメータ

設定値と戻り値

長整数型 (Long) の値を返します。プロバイダによっては、このプロパティが BLOB データのための予約されたスペースとして設定されていることがあります。その場合の既定値は 0 です。

説明

ActualSize プロパティは、Field オブジェクトの値の実際の長さを返すために使います。ActualSize プロパティはすべてのフィールドで読み取り専用です。Field オブジェクトの値の長さがわからない場合、ActualSize プロパティは adUnknown を返します。

共通のデータ型を持つデータの列を表します。

* ActualSize
* Attributes
* DefinedSize
* Name
* NumericScale
* OriginalValue
* Precision
* Status
* Type
* UnderlyingValue
* Value
* AppendChunk
* GetChunk

(PWS4 IIS4 IIS5)
Count — Errors コレクションからすべての Error オブジェクトを削除します。

構文

Errors.Count

戻り値

エラーの内容を表す文字列型 (String) を返します。

説明

Errors コレクションで Count メソッドを使って、既存の Error オブジェクトをすべて削除します。エラーが発生すると、Errors コレクションは自動的にクリアされ、新しく発生したエラーによる Error オブジェクトが格納されます。

プロパティとメソッドの中には、Errors コレクションの Error オブジェクトとして警告を返しても、プログラムの実行を停止しないものがあります。Recordset オブジェクトで Resync メソッド、UpdateBatch メソッド、または CancelBatch メソッドを呼び出す前、Connection オブジェクトで Open メソッドを呼び出す前、または Recordset オブジェクトで Filter プロパティを設定する前には、Errors コレクションで Count メソッドを呼び出してください。これらにより Errors コレクションの Count プロパティを読み込み、返された警告があるかどうかを調べることができます。

(PWS4 IIS4 IIS5)
Item — コレクションの特定のメンバをその名前またはインデックスで示します。

構文

Set object = collection.Item ( Index )

パラメータ

戻り値

オブジェクトへの参照を返します。

説明

コレクション内の特定のオブジェクトを返すには、Item プロパティを使います。コレクション内で Item が Index 引数に対応するオブジェクトを見つけられない場合、エラーが発生します。また、コレクションの中には名前付きオブジェクトをサポートしていないものもあります。このようなコレクションでは、その序数参照を使う必要があります。

Item プロパティはすべてのコレクションの既定プロパティなので、次のいずれの構文形式でも同じ結果が得られます。

例

(PWS4 IIS4 IIS5)
Clear — Errors コレクションからすべての Error オブジェクトを削除します。

構文

Errors.Clear

パラメータ

戻り値

エラーの内容を表す文字列型 (String) を返します。

説明

Errors コレクションで Clear メソッドを使って、既存の Error オブジェクトをすべて削除します。エラーが発生すると、Errors コレクションは自動的にクリアされ、新しく発生したエラーによる Error オブジェクトが格納されます。

プロパティとメソッドの中には、Errors コレクションの Error オブジェクトとして警告を返しても、プログラムの実行を停止しないものがあります。Recordset オブジェクトで Resync メソッド、UpdateBatch メソッド、または CancelBatch メソッドを呼び出す前、Connection オブジェクトで Open メソッドを呼び出す前、または Recordset オブジェクトで Filter プロパティを設定する前には、Errors コレクションで Clear メソッドを呼び出してください。これらにより Errors コレクションの Count プロパティを読み込み、返された警告があるかどうかを調べることができます。