SqlCeConnection 类
表示到 SQL Server Compact 数据源的连接是打开的。
继承层次结构
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbConnection
System.Data.SqlServerCe.SqlCeConnection
命名空间: System.Data.SqlServerCe
程序集: System.Data.SqlServerCe(在 System.Data.SqlServerCe.dll 中)
语法
声明
Public NotInheritable Class SqlCeConnection _
Inherits DbConnection
用法
Dim instance As SqlCeConnection
public sealed class SqlCeConnection : DbConnection
public ref class SqlCeConnection sealed : public DbConnection
[<SealedAttribute>]
type SqlCeConnection =
class
inherit DbConnection
end
public final class SqlCeConnection extends DbConnection
SqlCeConnection 类型公开以下成员。
构造函数
名称 | 说明 | |
---|---|---|
SqlCeConnection() | 初始化 SqlCeConnection 类的新实例。 | |
SqlCeConnection(String) | 使用指定的连接字符串初始化 SqlCeConnection 类的新实例。 |
页首
属性
名称 | 说明 | |
---|---|---|
CanRaiseEvents | (继承自 Component) | |
ConnectionString | 获取或设置用于打开数据库的字符串。 (覆盖 DbConnection.ConnectionString。) | |
ConnectionTimeout | 获取在终止尝试并生成错误之前等待并尝试建立连接的时间。 (覆盖 DbConnection.ConnectionTimeout。) | |
Container | (继承自 Component) | |
Database | 获取当前数据库或在连接打开后要使用的数据库的名称。 (覆盖 DbConnection.Database。) | |
DatabaseIdentifier | 同步时获取当前数据库的唯一标识符。 | |
DataSource | 获取数据源的文件名。 (覆盖 DbConnection.DataSource。) | |
DbProviderFactory | (继承自 DbConnection) | |
DesignMode | (继承自 Component) | |
Events | (继承自 Component) | |
ServerVersion | 以字符串形式返回数据库版本号。 (覆盖 DbConnection.ServerVersion。) | |
Site | (继承自 Component) | |
State | 获取连接的当前状态。 (覆盖 DbConnection.State。) |
页首
方法
页首
事件
名称 | 说明 | |
---|---|---|
Disposed | (继承自 Component) | |
FlushFailure | 当背景刷新失败时发生。 | |
InfoMessage | 在 SQL Server 的 .NET Compact Framework 数据提供程序发送警告或信息性消息时发生。 | |
StateChange | 当连接状态更改时发生。 (覆盖 DbConnection.StateChange。) |
页首
显式接口实现
名称 | 说明 | |
---|---|---|
IDbConnection.BeginTransaction() | (继承自 DbConnection) | |
IDbConnection.BeginTransaction(IsolationLevel) | (继承自 DbConnection) | |
IDbConnection.CreateCommand | (继承自 DbConnection) |
页首
注释
一个 SqlCeConnection 对象,表示到数据源的一个唯一的连接。当创建 SqlCeConnection 的实例时,所有属性都设置为它们的初始值。有关这些值的列表,请参阅 SqlCeConnection 构造函数。
如果 SqlCeConnection 超出范围,则不会将其关闭。必须通过调用 Close 或 Dispose 显式关闭该连接。
SQL Server Compact 不仅支持共享同一连接的多个命令,还支持多个并发连接。这意味着您可以使用同一个连接打开多个 SqlCeDataReader 实例。此行为不同于 System.Data.SqlClient 的行为。
如果执行 SqlCeCommand 的方法产生了致命的 SqlCeException,SqlCeConnection 可能会被关闭。您可以重新打开连接,然后继续。
示例
下面的示例创建了一个 SqlCeCommand 和一个 SqlCeConnection。SqlCeConnection 打开,并设置为 SqlCeCommand 的 Connection。然后,该示例调用 ExecuteNonQuery 并关闭该连接。
Dim conn As SqlCeConnection = Nothing
Try
conn = New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
conn.Open()
Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')"
cmd.ExecuteNonQuery()
Finally
conn.Close()
End Try
SqlCeConnection conn = null;
try
{
conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
conn.Open();
SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')";
cmd.ExecuteNonQuery();
}
finally
{
conn.Close();
}
线程安全
此类型的任何公共静态(在 Microsoft Visual Basic 中为共享)成员是线程安全的。不保证所有实例成员都对于线程安全的。