SQLState

(PWS4 IIS4 IIS5)
SQLState — 指定された Error オブジェクトの SQL 状態を示します。

構文

object.SQLState

パラメータ

object Error オブジェクトを指定します。

戻り値

ANSI SQL 標準に準拠する 5 文字の文字列型 (String) の値を返してエラー コードを示します。

説明

SQL ステートメントの処理中にエラーが発生した場合に、プロバイダが返す 5 文字のエラー コードを読み取るには、SQLState プロパティを使用します。たとえば、Microsoft OLE DB Provider for ODBC を Microsoft SQL Server データベースと共に使う場合、ODBC 固有のエラー、または Microsoft SQL Server に起因するエラーに基づいて SQL 状態のエラー コードが生成されると、ODBC エラーにマップされます。これらのエラー コードは ANSI SQL 標準に対応していますが、データ ソースによっては実装方法が異なる場合があります。


Source

(PWS4)
Source — エラーの発生源のオブジェクト名またはアプリケーション名を示します。

構文

object.Source

パラメータ

object Error オブジェクトを指定します。

戻り値

オブジェクトまたはアプリケーションの名前を示す文字列型 (String) の値を返します。

説明

エラーの発生源のオブジェクト名またはアプリケーション名を調べるには、Error オブジェクトの Source プロパティを使います。これは、オブジェクトのクラス名またはプログラム ID になる場合があります。ADO のエラーの場合、プロパティ値は ADODB.ObjectName になり、ObjectName はエラーの発生源のオブジェクト名を表します。ADOX および ADO MD の場合、値はそれぞれ ADOX.ObjectName および ADOMD.ObjectName になります。

Error オブジェクトの Source プロパティ、Number プロパティ、および Description プロパティからエラー情報を得ることにより、エラーを適切に処理するためのコードを書くことができます。

Error オブジェクトの Source プロパティは読み取り専用です。


Number

(PWS4 IIS4 IIS5)
Number — Error オブジェクトを一意に識別する数値を示します。

構文

object.Number

パラメータ

object Error オブジェクトを指定します。

戻り値

ErrorValueEnum 定数のいずれかに対応する長整数型 (Long) の値を返します。

説明

発生したエラーを調べるには、Number プロパティを使います。プロパティの値は、エラー条件に対応した固有の数値です。

Errors コレクションは、16 進形式 (例: 0x80004005) または長整数型 (例: 2147467259) で HRESULT を返します。これらの HRESULT は、OLE DB や場合によっては OLE 自体など、基になるコンポーネントから生成されます。


NativeError

(PWS4 IIS4 IIS5)
NativeError — 特定の Error オブジェクトの、プロバイダ固有のエラー コードを示します。

構文

object.NativeError

パラメータ

object Error オブジェクトの名前を指定します。

戻り値

エラー コードを示す長整数型 (Long) の値を返します。

説明

NativeError プロパティを使って、特定の Error オブジェクトの、データベース固有のエラー情報を取得します。たとえば、Microsoft ODBC Provider for OLE DB と Microsoft SQL Server データベースを使う場合、SQL Server から送信されたネイティブ エラー コードは、ODBC と ODBC Provider を経由して ADO の NativeError プロパティに渡されます。


HelpFile

(PWS4 IIS4 IIS5)
HelpFile — Error オブジェクトに関連するヘルプ ファイルおよびヘルプ トピックを示します。

構文

object.HelpFile

パラメータ

object Error オブジェクを指定します。

戻り値

ヘルプ ファイルへの完全なパスを示す文字列型 (String) の値を返します。

説明

該当するヘルプ トピックがない場合、HelpContext プロパティは 0 を返し、HelpFile プロパティは長さ 0 の文字列 (“”) を返します。


HelpContext

(PWS4 IIS4 IIS5)
HelpContext — Error オブジェクトに関連するヘルプ ファイルおよびヘルプ トピックを示します。

構文

object.HelpContext

パラメータ

object Error オブジェクトの名前を指定します。

戻り値

ヘルプ ファイルのトピックのコンテキスト ID を長整数型 (Long) の値で返します。

説明

HelpFile プロパティでヘルプ ファイルが指定されている場合、HelpContext プロパティを使って特定のヘルプ トピックを自動的に表示できます。


Description

(PWS4 IIS4 IIS5)
Description — Error オブジェクトを説明します。

構文

object.Description

パラメータ

object Error オブジェクトの名前を指定します。

戻り値

エラーの内容を表す文字列型 (String) を返します。

説明

エラーの簡単な説明を得るには、Description プロパティを使います。プログラムで対処できない、あるいは処理をすることが望ましくないエラーは、このプロパティの内容を表示してユーザーに警告します。文字列は、ADO またはプロバイダから返されます。

エラー テキストは、プロバイダから ADO に渡されます。ADO は、受け取ったプロバイダ エラーまたは警告ごとに Error オブジェクトを Errors コレクションに追加します。プロバイダが渡すエラーを調べるには、Errors コレクションを列挙します。