OleDbException

.NET Framework クラス ライブラリ リファレンス

OleDbException クラス

基になるプロバイダが OLE DB データ ソースに関する警告またはエラーを返したときにスローされる例外。このクラスは継承できません。

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 OleDbException
    Inherits DbException

Visual Basic (使用法)

Dim instance As OleDbException

C#

[SerializableAttribute] 
public sealed class OleDbException : DbException

C++

[SerializableAttribute] 
public ref class OleDbException sealed : public
 DbException

J#

/** @attribute SerializableAttribute() */ 
public final class OleDbException extends DbException

JScript

SerializableAttribute 
public final class OleDbException extends
 DbException

解説

このクラスは、サーバーが生成したエラーを .NET Framework OLE DB 用データ プロバイダが検出するたびに作成されます。クライアント側のエラーは、標準共通言語ランタイム例外としてスローされます。OleDbException には、常に、OleDbError のインスタンスが少なくとも 1 つ含まれています。

エラーの重大度レベルが非常に高い場合は、サーバーが OleDbConnection を閉じることがあります。ただし、ユーザーは接続を再び開いて、処理を継続できます。

使用例

データ ソースが見つからないために発生する OleDbException を生成し、その例外を表示する例を次に示します。

Visual Basic

Public Sub ShowOleDbException()
    Dim mySelectQuery As String
 = "SELECT column1 FROM table1"
    Dim myConnection As New
 OleDbConnection _
       ("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=")
    Dim myCommand As New
 OleDbCommand(mySelectQuery, myConnection)

    Try
        myCommand.Connection.Open()
    Catch e As OleDbException
        Dim errorMessages As String
        Dim i As Integer

        For i = 0 To e.Errors.Count - 1
            errorMessages += "Index #" & i.ToString()
 & ControlChars.Cr _
                           & "Message: " &
 e.Errors(i).Message & ControlChars.Cr _
                           & "NativeError: " &
 e.Errors(i).NativeError & ControlChars.Cr _
                           & "Source: " &
 e.Errors(i).Source & ControlChars.Cr _
                           & "SQLState: " &
 e.Errors(i).SQLState & ControlChars.Cr
        Next i

       Dim log As System.Diagnostics.EventLog
 = New System.Diagnostics.EventLog()
       log.Source = "My Application"
       log.WriteEntry(errorMessages)
       Console.WriteLine("An exception occurred. Please contact
 your system administrator.")
    End Try
End Sub

C#

public void ShowOleDbException() 
{
   string mySelectQuery = "SELECT column1 FROM table1";
   OleDbConnection myConnection =
      new OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=");
   OleDbCommand myCommand = new OleDbCommand(mySelectQuery,myConnection);

   try 
   {
      myCommand.Connection.Open();
   }
   catch (OleDbException e) 
   {
     string errorMessages = "";

     for (int i=0; i < e.Errors.Count; i++)
     {
         errorMessages += "Index #" + i + "\n" +
                          "Message: " + e.Errors[i].Message + "\n"
 +
                          "NativeError: " + e.Errors[i].NativeError + "\n"
 +
                          "Source: " + e.Errors[i].Source + "\n"
 +
                          "SQLState: " + e.Errors[i].SQLState + "\n";
     }

     System.Diagnostics.EventLog log = new System.Diagnostics.EventLog();
     log.Source = "My Application";
     log.WriteEntry(errorMessages);
     Console.WriteLine("An exception occurred. Please contact your system administrator.");
   }
}

継承階層

System.Object
   System.Exception
     System.SystemException
       System.Runtime.InteropServices.ExternalException
         System.Data.Common.DbException
          System.Data.OleDb.OleDbException

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
OleDbException メンバ
System.Data.OleDb 名前空間
OleDbErrorCollection クラス
その他の技術情報
例外の概要

OleDbException プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 ( Exception から継承されます。)
	ErrorCode	オーバーライドされます。 エラーの HRESULT を取得します。
	Errors	.NET Framework OLE DB 用データ プロバイダが生成する例外の詳細情報を提供する、1 つ以上の OleDbError オブジェクトのコレクションを取得します。
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 ( Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。 ( Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。 ( Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 ( Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。 ( Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。 ( Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 ( Exception から継承されます。)

参照

関連項目

OleDbException クラス
System.Data.OleDb 名前空間
OleDbErrorCollection クラス

その他の技術情報

例外の概要

OleDbException メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	オーバーライドされます。 このメンバは GetObjectData をオーバーライドします。
	GetType	現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 ( Exception から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

OleDbException クラス
System.Data.OleDb 名前空間
OleDbErrorCollection クラス

その他の技術情報

例外の概要

OleDbException メンバ

基になるプロバイダが OLE DB データ ソースに関する警告またはエラーを返したときにスローされる例外。このクラスは継承できません。

OleDbException データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
	ErrorCode	オーバーライドされます。 エラーの HRESULT を取得します。
	Errors	.NET Framework OLE DB 用データ プロバイダが生成する例外の詳細情報を提供する、1 つ以上の OleDbError オブジェクトのコレクションを取得します。
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。(Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。(Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。(Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。(Exception から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	オーバーライドされます。 このメンバは GetObjectData をオーバーライドします。
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

OleDbException クラス
System.Data.OleDb 名前空間
OleDbErrorCollection クラス

その他の技術情報

例外の概要