Errors コレクション (ADO)

適用先: Access 2013、Office 2013

プロバイダー関連の 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 プロパティを読み取り、返された警告を調べることができます。

注:

[!メモ] 1 つの ADO 操作で複数のエラーが発生する場合の詳細については、 Error オブジェクトのトピックを参照してください。