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 对象的集合，这些对象包含有关用于 SQL Server Compact 的 .NET Compact Framework 数据提供程序生成的异常的详细信息。
	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）

页首

注释

每当用于 SQL Server Compact 的 .NET Compact Framework 数据提供程序遇到 SQL Server Compact 引擎中生成的错误时，都将创建此类。（其他错误作为标准的公共语言运行时异常引发。）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 中为共享）成员是线程安全的。不保证所有实例成员都对于线程安全的。

请参阅

参考

System.Data.SqlServerCe 命名空间

SqlCeError

SqlCeErrorCollection