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 オブジェクトのトピックを参照してください。
このセクションのトピックは次のとおりです。