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