次の方法で共有


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 オブジェクトで ResyncUpdateBatch、または CancelBatch メソッドを呼び出す前や、Connection オブジェクトで Open メソッドを呼び出す前、または Recordset オブジェクトの Filter プロパティを設定する前に、Errors コレクションで Clear メソッドを呼び出してください。 このようにして、Errors コレクションの Count プロパティを読み取って、返された警告のテストができます。

注意

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

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

参照

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