共用方式為


SqlCeException 類別

當基礎提供者從 SQL Server Compact 資料來源傳回警告或錯誤時,所擲回的例外狀況。這個類別無法被繼承。

繼承階層

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.Data.Common.DbException
          System.Data.SqlServerCe.SqlCeException
            System.Data.SqlServerCe.SqlCeInvalidDatabaseFormatException
            System.Data.SqlServerCe.SqlCeLockTimeoutException
            System.Data.SqlServerCe.SqlCeTransactionInProgressException

命名空間:  System.Data.SqlServerCe
組件:  System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)

語法

'宣告
<SerializableAttribute> _
Public Class SqlCeException _
    Inherits DbException
'用途
Dim instance As SqlCeException
[SerializableAttribute]
public class SqlCeException : DbException
[SerializableAttribute]
public ref class SqlCeException : public DbException
[<SerializableAttribute>]
type SqlCeException =  
    class
        inherit DbException
    end
public class SqlCeException extends DbException

SqlCeException 型別公開下列成員。

建構函式

  名稱 說明
受保護的方法 SqlCeException 協助序列化的建構函式。

上層

屬性

  名稱 說明
公用屬性 Data (繼承自 Exception)
公用屬性 ErrorCode (繼承自 ExternalException)
公用屬性 Errors 取得一個或多個SqlCeError 物件的集合,這些物件包含由 .NET Compact Framework Data Provider for SQL Server Compact 所產生之例外狀況的相關詳細資訊。
公用屬性 HelpLink (繼承自 Exception)
公用屬性 HResult 取得例外狀況的 HRESULT 值。這個值與例外狀況的 SqlCeErrorCollection 中的第一個 SqlCeError 執行個體的 HResult 值相同。
公用屬性 InnerException (繼承自 Exception)
公用屬性 Message 取得描述此例外狀況的 SqlCeErrorCollection 中第一個 SqlCeError 執行個體的文字。 (覆寫 Exception.Message。)
公用屬性 NativeError 取得 SqlCeErrorCollection 中第一個 SqlCeError 的原生錯誤號碼。如需有關此錯誤的詳細資訊,請參閱《SQL Server Compact 線上叢書》中<疑難排解>一節內的「SQL Server Compact 錯誤」主題。
公用屬性 Source 取得產生錯誤的 OLE DB 提供者名稱。 (覆寫 Exception.Source。)
公用屬性 StackTrace (繼承自 Exception)
公用屬性 TargetSite (繼承自 Exception)

上層

方法

  名稱 說明
公用方法 Equals (繼承自 Object)
受保護的方法 Finalize (繼承自 Object)
公用方法 GetBaseException (繼承自 Exception)
公用方法 GetHashCode (繼承自 Object)
公用方法 GetObjectData 安全性關鍵。使用序列化物件時所需的資料來擴展 SerializationInfo。 (覆寫 Exception.GetObjectData(SerializationInfo, StreamingContext)。)
公用方法 GetType (繼承自 Exception)
受保護的方法 MemberwiseClone (繼承自 Object)
公用方法 ToString (繼承自 Exception)

上層

備註

每當 .NET Compact Framework Data Provider for SQL Server Compact 遇到 SQL Server Compact 引擎中產生的錯誤時,就會建立這個類別 (其他錯誤是以標準 Common Language Runtime 例外狀況來擲回)。SqlCeException 一定會至少包含一個 SqlCeError 執行個體。

範例

下列範例會由於遺漏資料來源而產生 SqlCeException,然後顯示例外狀況。

Dim conn As New SqlCeConnection("Data Source=nonExistingSource.sdf;")

Try
    conn.Open()
Catch e As SqlCeException
    ' Use SqlCeException properties if you need specific
    ' application logic depending on the error condition
    '
    If 25046 = e.NativeError Then 'SSCE_M_FILENOTFOUND
        ' Error specific logic goes here...
        '
    End If

    MessageBox.Show(e.Message)
End Try
SqlCeConnection conn = new SqlCeConnection("Data Source=nonExistingSource.sdf;");

try
{
    conn.Open();
}
catch (SqlCeException e)
{
    // Use SqlCeException properties if you need specific
    // application logic depending on the error condition
    //
    if (25046 == e.NativeError /*SSCE_M_FILENOTFOUND*/)
    {
        // Error specific logic goes here...
        //
    }

    MessageBox.Show(e.Message);
}

執行緒安全性

這個類型的任何公用靜態 (在 Microsoft Visual Basic 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。

請參閱

參考

System.Data.SqlServerCe 命名空間

SqlCeError

SqlCeErrorCollection