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。）

页首

方法

	名称	说明
	BeginDbTransaction	（继承自 DbConnection）
	BeginTransaction()	开始数据库事务。
	BeginTransaction(IsolationLevel)	以当前的 IsolationLevel 值开始数据库事务。
	ChangeDatabase	为打开的 SqlCeConnection 更改当前数据库。 （覆盖 DbConnection.ChangeDatabase(String)。）
	Close	关闭到数据源的连接。这是关闭任何打开连接的首选方法。 （覆盖 DbConnection.Close()。）
	CreateCommand	创建并返回一个与 SqlCeConnection 关联的 SqlCeCommand 对象。
	CreateDbCommand	（继承自 DbConnection）
	CreateObjRef	（继承自 MarshalByRefObject）
	Dispose()	释放 SqlCeConnection 类的当前实例所使用的所有资源。
	Dispose(Boolean)	（继承自 Component）
	EnlistTransaction(Transaction)	（继承自 DbConnection）
	EnlistTransaction(Transaction)	登记指定的 Transaction。
	Equals	（继承自 Object）
	Finalize	（继承自 Component）
	GetDatabaseInfo	返回一组键值对，包含关于已连接数据库的区域设置、加密模式和区分大小写设置的信息。
	GetHashCode	（继承自 Object）
	GetLifetimeService	（继承自 MarshalByRefObject）
	GetSchema()	返回此 SqlCeConnection 的数据源的架构信息。 （覆盖 DbConnection.GetSchema()。）
	GetSchema(String)	使用该架构名称的指定字符串返回此 SqlCeConnection 的数据源的架构信息。 （覆盖 DbConnection.GetSchema(String)。）
	GetSchema(String, array<String[])	使用该架构名称的指定字符串以及限制值的指定字符串数组返回此 SqlCeConnection 的数据源的架构信息。 （覆盖 DbConnection.GetSchema(String, array<String[])。）
	GetService	（继承自 Component）
	GetType	（继承自 Object）
	InitializeLifetimeService	（继承自 MarshalByRefObject）
	MemberwiseClone()	（继承自 Object）
	MemberwiseClone(Boolean)	（继承自 MarshalByRefObject）
	OnStateChange	（继承自 DbConnection）
	Open	使用 ConnectionString 所指定的属性设置打开数据库连接。 （覆盖 DbConnection.Open()。）
	ToString	（继承自 Component）

页首

事件

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

请参阅

参考

System.Data.SqlServerCe 命名空间

SqlCeDataAdapter

SqlCeCommand