OdbcException クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

OdbcException クラス

ODBC データソースから警告またはエラーが返された場合に生成される例外。このクラスは継承できません。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 OdbcException
    Inherits DbException

Visual Basic (使用法)

Dim instance As OdbcException

[SerializableAttribute] 
public sealed class OdbcException : DbException

C++

[SerializableAttribute] 
public ref class OdbcException sealed : public
 DbException

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

JScript

SerializableAttribute 
public final class OdbcException extends
 DbException

解説

このクラスは、サーバーが生成したエラーを OdbcDataAdapter が検出するたびに作成されます。クライアント側のエラーは、標準の共通言語ランタイム例外として発生します。このクラスには、常に、OdbcError のインスタンスが少なくとも 1 つ含まれます。

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

使用例

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

Visual Basic

Public Sub ShowOdbcException()
    Dim mySelectQuery As String
 = "SELECT column1 FROM table1"
    Dim myConnection As New
 OdbcConnection _
       ("DRIVER={SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;")
    Dim myCommand As New
 OdbcCommand(mySelectQuery, myConnection)
    Try
        myCommand.Connection.Open()
    Catch e As OdbcException
        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.ToString() & ControlChars.Cr _
                           & "Source: " &
 e.Errors(i).Source & ControlChars.Cr _
                           & "SQL: " & 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

public void ShowOdbcException() 
{
   string mySelectQuery = "SELECT column1 FROM table1";
   OdbcConnection myConnection =
      new OdbcConnection("DRIVER={SQL Server};SERVER=MyServer;Trusted_connection=yes;DATABASE=northwind;");
   OdbcCommand myCommand = new OdbcCommand(mySelectQuery,myConnection);
   try 
   {
      myCommand.Connection.Open();
   }
   catch (OdbcException 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.ToString()
 + "\n" +
                          "Source: " + e.Errors[i].Source + "\n"
 +
                          "SQL: " + 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.Odbc.OdbcException

スレッドセーフ

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