サンプルコードで学ぶASP

(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 プロパティを読み込み、返された警告があるかどうかを調べることができます。

1 つのプロバイダ関連エラーが発生したプロバイダに対して発生するすべての Error オブジェクトを格納します。

* Clear
* Item
* Count

(PWS4 IIS4 IIS5)
SQLState — 指定された Error オブジェクトの SQL 状態を示します。

構文

object.SQLState

パラメータ

戻り値

ANSI SQL 標準に準拠する 5 文字の文字列型 (String) の値を返してエラー コードを示します。

説明

SQL ステートメントの処理中にエラーが発生した場合に、プロバイダが返す 5 文字のエラー コードを読み取るには、SQLState プロパティを使用します。たとえば、Microsoft OLE DB Provider for ODBC を Microsoft SQL Server データベースと共に使う場合、ODBC 固有のエラー、または Microsoft SQL Server に起因するエラーに基づいて SQL 状態のエラー コードが生成されると、ODBC エラーにマップされます。これらのエラー コードは ANSI SQL 標準に対応していますが、データ ソースによっては実装方法が異なる場合があります。

(PWS4)
Source — エラーの発生源のオブジェクト名またはアプリケーション名を示します。

構文

object.Source

パラメータ

戻り値

オブジェクトまたはアプリケーションの名前を示す文字列型 (String) の値を返します。

説明

エラーの発生源のオブジェクト名またはアプリケーション名を調べるには、Error オブジェクトの Source プロパティを使います。これは、オブジェクトのクラス名またはプログラム ID になる場合があります。ADO のエラーの場合、プロパティ値は ADODB.ObjectName になり、ObjectName はエラーの発生源のオブジェクト名を表します。ADOX および ADO MD の場合、値はそれぞれ ADOX.ObjectName および ADOMD.ObjectName になります。

Error オブジェクトの Source プロパティ、Number プロパティ、および Description プロパティからエラー情報を得ることにより、エラーを適切に処理するためのコードを書くことができます。

Error オブジェクトの Source プロパティは読み取り専用です。

ADO 実行時エラーの種類を表します。

エラー番号には 3 種類の形式があります。

* 正の 10 進値
– 10進数で表された完全エラー番号の下位 2 バイト。この数値は、Visual Basic の既定のエラー メッセージ ダイアログ ボックスに表示されます。たとえば、実行時エラー ‘3707’ がその例です。
* 負の 10 進値
– 完全エラー番号を 10 進数に変換したもの。
* 16 進値
– 完全エラー番号の 16 進数表記。Windows 機能コードは 4 桁目です。ADO エラー番号の機能コードは、A です。たとえば、0x800A0E7B がその例です。

注意 OLE DB エラーは、ADO アプリケーションに渡すことができます。通常、これらの値は、Windows 機能コード 4 で表します。