Error オブジェクト
プロバイダーが関係する 1 つの操作に関連するデータ アクセス エラーに関する詳細が含まれています。
備考
ADO オブジェクトに関連する操作では、1 つ以上のプロバイダー エラーが生成される可能性があります。 各エラーが発生すると、1 つ以上の Error オブジェクトが、Connection オブジェクトの Errors コレクションに配置されます。 別の ADO 操作でエラーが生成されると、Errors コレクションがクリアされ、Error オブジェクトの新しいセットが Errors コレクションに配置されます。
手記
各 Error オブジェクトは、ADO エラーではなく、特定のプロバイダー エラーを表します。 ADO エラーは、実行時例外処理メカニズムに公開されます。 たとえば、Microsoft Visual Basic では、ADO 固有のエラーが発生すると、On Error イベントがトリガーされ、Error オブジェクトに表示されます。 ADO エラーの完全な一覧については、ErrorValueEnum トピックを参照してください。
Error オブジェクトのプロパティを読み取り、次のような各エラーに関する具体的な詳細を取得できます。
Description プロパティです。このプロパティには、エラーのテキストが含まれます。 これが既定のプロパティです。
Number プロパティ。エラー定数の Long 整数値が含まれます。
Source プロパティ。エラーが発生したオブジェクトを識別します。 これは、データ ソースへの要求の後に、Errors コレクションに複数の Error オブジェクトがある場合に特に便利です。
SQLState および NativeError プロパティ。SQL データ ソースからの情報を提供します。
プロバイダー エラーが発生すると、Connection オブジェクトの Errors コレクションに配置されます。 ADO では、プロバイダー固有のエラー情報を許可するために、単一の ADO 操作による複数のエラーの返しがサポートされています。 エラー ハンドラーでこの豊富なエラー情報を取得するには、使用している言語または環境の適切なエラー トラップ機能を使用し、入れ子になったループを使用して、Errors コレクション内の各 Error オブジェクトのプロパティを列挙します。
手記
Microsoft Visual Basic および VBScript ユーザー 有効な Connection オブジェクトがない場合は、Error オブジェクトからエラー情報を取得する必要があります。
プロバイダーが行うのと同様に、ADO は、新しいプロバイダー エラーを生成する可能性がある呼び出しを行う前に、OLE エラー情報 オブジェクト をクリアします。 ただし、Connection オブジェクトの Errors コレクションは、プロバイダーが新しいエラーを生成したとき、または Clear メソッドが呼び出された場合にのみクリアされ、設定されます。
一部のプロパティとメソッドは、Errors コレクション内の Error オブジェクトとして表示される警告を返しますが、プログラムの実行は停止しません。 Recordset オブジェクトで Resync、UpdateBatch、または CancelBatch メソッドを する前に、Connection オブジェクトの Open メソッド。または、Recordset オブジェクトの Filter プロパティを設定し、Errors コレクションで Clear メソッドを呼び出します。 こうすることで、Errors コレクションの Count プロパティを読み取り、返された警告をテストできます。
Error オブジェクトは、スクリプトを作成しても安全ではありません。
このセクションには、次のトピックが含まれています。
関連項目
Description、HelpContext、HelpFile、NativeError、Number、Source、SQLState プロパティの使用例 (VB)
Description、HelpContext、HelpFile、NativeError、Number、Source、SQLState プロパティの使用例 (VC++)
Connection オブジェクト (ADO)
Errors コレクション (ADO)
付録 A: プロバイダー