Description プロパティは、ADO またはデータプロバイダが生成したエラーまたは警告を記述します。

String

Error オブジェクトの Description プロパティは読み取り専用です。このプロパティは、エラーや警告の情報を文字列形式で提供するため、アプリケーションのユーザーにエラーや警告が発生したことを通知できます。

Description プロパティの値は、ADO またはプロバイダから取得できます。

HelpContext プロパティと HelpFile プロパティは、それぞれ Error オブジェクト内の特定のエラーのトピックと名前を示します。

HelpFile プロパティは、Windows ヘルプファイルへの絶対パスを保持します。

HelpContext プロパティは、HelpFile プロパティで示される Windows ヘルプファイルから自動的にヘルプトピックを表示します。

生成されたエラーに関連するヘルプトピックがない場合、HelpContext プロパティは 0 を返し、HelpFile プロパティは空の文字列 (") を返します。

NativeError プロパティは、現在の Error オブジェクトのデータプロバイダから提供されたエラーコードを返します。

Long

このプロパティを使用すると、データソース、ADO の順に渡されるエラーコードを取得できます。

Number プロパティを使用すると、現在の Error オブジェクトで指定されたエラーを一意に識別できます。

Long または ErrorValueEnum (Long)

Number プロパティの値は、発生したエラーを記述する固有の番号です。この値は、表 E-18 に示すいずれかの ErrorValueEnum 列挙値です。

ErrorValueEnum 列挙

Source プロパティは、ADO 内でエラーを生成したオブジェクトまたはアプリケーションの名前を返します。

Error オブジェクトは String を返します。

Errors オブジェクトの場合、Source プロパティは、最初に ADO 内でエラーを生成したオブジェクトまたはアプリケーションの名前を示します。

ADO エラーには、ADODB. という値で始まり、エラーを生成したオブジェクト名が続くソース値があります。

SQLState プロパティは、現在の Error オブジェクトの SQL 状態を返します。

String (5 文字)

このプロパティを使用すると、SQL ステートメントの処理でエラーが発生したときにデータプロバイダが ADO に返す、5 文字のエラーコードを取得できます。これらのエラーコードは ANSI SQL 規格に従う必要がありますが、データプロバイダによっては、準拠しないものもあります。

Errors コレクションに関する詳細と例については、「Error オブジェクト」を参照してください。

Error

操作中に ADO によって生成された特定のエラーまたは警告に関する情報を保持します。

Clear

Clear メソッドは、Errors コレクションに格納されているすべてのエラーを消去します。

Refresh

Errors コレクションの Refresh メソッドは、バージョン 2.0 以降に存在しているマニュアルに未記載の ADO のメソッドです。

Count

関連する Errors コレクションに属する Error オブジェクトの数を示します。

Item

Errors コレクションに属する特定の Error オブジェクトにアクセスします。

Clear メソッドは、Errors コレクションに格納されているすべてのエラーを消去します。

Clear メソッドは、ADO エラーの現在のコレクションをクリアします。新しいランタイムエラーが発生すると、Errors コレクションは自動的にクリアされ、エラー情報が書き込まれます。

複数の警告が返される可能性がある Recordset オブジェクトを呼び出す場合に、Clear メソッドを使用します。該当する呼び出しとしては、Delete、Resync、UpdateBatch、および CancelBatch があります。Errors コレクションをクリアした後にこれらのいずれかを呼び出すと、問題の呼び出しで警告が生成されたかどうかを判断できます。

Recordset.CancelBatch メソッド、Recordset.Delete メソッド、Recordset.Resync メソッド、Recordset.UpdateBatch メソッド

Count プロパティは、関連する Errors コレクションに属する Error オブジェクトの数を示します。

Long

Count プロパティの値が 0 の場合、関連する Errors コレクション内には Error オブジェクトはありません。ただし、関連する Errors コレクションに属する Error オブジェクトには、0 〜 (Count プロパティの値 - 1) のインデックスが設定されます。

Item プロパティは、Errors コレクションに属する特定の Error オブジェクトにアクセスします。

Error オブジェクト

Index プレースホルダーは、Errors コレクション内の Error オブジェクトの順序を表す Variant データタイプを表します。Errors コレクションに要求された項目がない場合、エラーが発生します。

言語によっては、最初の構文の Item プロパティをサポートしていないものもあります。それらの言語では、Item メソッド名なしの 2 番目の構文を使用します。

Errors コレクションの Refresh メソッドは、バージョン 2.0 以降に存在しているマニュアルに未記載の ADO のメソッドです。

Errors.Refresh メソッドは、ADO 内のエラーを再度クエリーします。