Errors コレクション (ADO)

1 つのプロバイダー関連の失敗に応答して作成されたすべての Error オブジェクトが含まれます。

注釈

ADO オブジェクトを含む操作では、1 つまたは複数のプロバイダー エラーが発生する可能性があります。 各エラーが発生したときに、1 つ以上のError オブジェクトを Connection オブジェクトの Errors コレクションに配置できます。 別の ADO 操作でエラーが生成されると、Errors コレクションがクリアされるので、Error オブジェクトの新しいセットを Errors コレクションに配置できます。

各 Error オブジェクトは、ADO エラーではなく、特定のプロバイダー エラーを表します。 ADO エラーは、実行時の例外処理メカニズムに公開されます。 たとえば、Microsoft Visual Basic では、ADO 固有のエラーが発生すると onError イベントがトリガーされ、Err オブジェクトに表示されます。

エラーを生成しない ADO 操作は、Errors コレクションには影響しません。 Errors コレクションを手動でクリアするには、Clear メソッドを使用します。

Errors コレクション内の Error オブジェクトのセットには、1 つのステートメントに応答して発生したすべてのエラーが記述されます。 Errors コレクション内の特定のエラーを列挙すると、エラー処理ルーチンで、エラーの原因と発生元がより正確に特定され、復旧するための適切な手順を実行できます。

一部のプロパティとメソッドが返す警告は、Errors コレクション内の Error オブジェクトとして表示されますが、プログラムの実行を停止しません。 Recordset オブジェクトで Resync、UpdateBatch、または CancelBatch メソッドを呼び出す前や、Connection オブジェクトで Open メソッドを呼び出す前、または Recordset オブジェクトの Filter プロパティを設定する前に、Errors コレクションで Clear メソッドを呼び出してください。 このようにして、Errors コレクションの Count プロパティを読み取って、返された警告のテストができます。

注意

単一の ADO 操作で複数のエラーを生成する方法のより詳しい説明については、Error オブジェクトのトピックを参照してください。

このセクションのトピックは次のとおりです。

• エラー コレクションのプロパティ、メソッド、およびイベント

参照

Error オブジェクト
付録 A: プロバイダー