DB2异常类

数据库返回警告或错误时生成的异常。

名称空间:
IBM.Data.DB2
组合件:
IBM.Data.DB2 (在 IBM.Data.DB2.dll中)

.NET Framework 2.0、3.0、3.5 和 4.0 继承层次结构


System.Object
   System.Exception
      System.SystemException
         System.Runtime.InteropServices.SystemException
            System.Data.Common.DbException
               IBM.Data.DB2.DB2Exception

.NET Framework 2.0、3.0、3.5 和 4.0 语法


[Visual Basic]
<Serializable>
NotInheritable Public Class DB2Exception
   Inherits DbException
[C#]
[Serializable]
public sealed class DB2Exception : DbException
[C++]
[Serializable]
public __gc __sealed class DB2Exception : public DbException
[JScript]
public
   Serializable
class DB2Exception extends DbException

注释

每当数据库服务器产生错误时,就会创建此类。 (将以标准公共语言运行时异常的形式引发客户端错误。) 它始终至少包含一个 DB2®错误 实例。

如果错误的严重性太大,那么服务器可以关闭 DB2连接 。 如果服务器关闭了连接,那么应用程序将需要打开新的连接。

示例

[Visual Basic , C#] 以下示例由于缺少数据库而生成 DB2Exception ,然后显示异常。

[Visual Basic]
Public Sub ThrowDB2Exception()
    Dim mySelectQuery As String = "SELECT column1 FROM table1"
    Dim myConnection As New DB2Connection _
       ("DATABASE=BADDB;")
    Dim myCommand As New DB2Command(mySelectQuery, myConnection)
    Try
        myCommand.Connection.Open()
    Catch myException As DB2Exception
        Dim i As Integer
        For i = 0 To myException.Errors.Count - 1
            MessageBox.Show("Index #" + i.ToString() + ControlChars.Cr _
               + "Message: " + myException.Errors(i).Message 
                             + ControlChars.Cr _
               + "Native: " + myException.Errors(i).NativeError.ToString() 
                  + ControlChars.Cr _
               + "Source: " + myException.Errors(i).Source + ControlChars.Cr _
               + "SQL: " + myException.Errors(i).SQLState + ControlChars.Cr)
        Next i
    End Try
End Sub

[C#]
public void ThrowDB2Exception()
{
   string mySelectQuery = "SELECT column1 FROM table1";
   DB2Connection myConnection =
      new DB2Connection("DATABASE=BADDB;");
   DB2Command myCommand = new DB2Command(mySelectQuery,myConnection);
   try
   {
      myCommand.Connection.Open();
   }
   catch (DB2Exception myException)
   {
      for (int i=0; i < myException.Errors.Count; i++)
     {
         MessageBox.Show("Index #" + i + "\n" +
             "Message: " + myException.Errors[i].Message + "\n" +
             "Native: " + myException.Errors[i].NativeError.ToString() + "\n" +
             "Source: " + myException.Errors[i].Source + "\n" +
             "SQL: " + myException.Errors[i].SQLState + "\n");
     }
   }
}

线程安全

此类型的任何公用静态(在 Visual Basic 中为Shared)成员对于多线程操作都是安全的。 不保证任何实例成员均为线程安全。