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 中为共享)成员是线程安全的。不保证所有实例成员都对于线程安全的。