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

public final class SqlCeConnection extends DbConnection

public final class SqlCeConnection extends DbConnection

不适用。

备注

一个 SqlCeConnection 对象，表示到数据源的一个唯一的连接。当创建 SqlCeConnection 的实例时，所有属性都设置为它们的初始值。有关这些值的列表，请参见 SqlCeConnection 构造函数。

如果 SqlCeConnection 超出范围，则不会将其关闭。因此，必须通过调用 Close 或 Dispose 显式关闭该连接。

 Microsoft SQL Server 2005 Compact Edition 不仅支持共享同一连接的多个命令，还支持多个并发连接。这意味着使用同一个连接可以打开多个 SqlCeDataReader 实例。此行为不同于 System.Data.SqlClient 的行为。

如果执行 SqlCeCommand 的方法产生了致命的 SqlCeException，SqlCeConnection 可能会被关闭。您可以重新打开连接并继续。

目前未优化 SQL Server Compact Edition 来充当网站的数据库。默认情况下，在 SQL Server Compact Edition 中，来自与 ASP.NET 相连的应用程序的连接受到阻止。SQL Server Compact Edition 已经过优化，可用作应用程序内的嵌入式数据库。将 SQL Server Compact Edition 用作网站的数据库需要多用户和并发数据更改支持。这可能引起性能问题。因此，不支持这些方案。SQL Server 2005 的其他版本（包括 SQL Server 2005 Express Edition）已经过优化，可充当网站的数据库。

在 ASP.NET 用来为同步方案创建 SQL Server Compact Edition 数据库的应用程序方案中，SQL Server Compact Edition 可与 ASP.NET 一起使用。使用下面的代码更改 Compact Edition 的默认行为，以便在 ASP.NET 内使用。

AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", true)

示例

下面的示例创建一个 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();
}

继承层次结构

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.SqlServerCe.SqlCeConnection

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Windows Vista、Microsoft Windows XP SP2 和 Windows Server 2003 SP1 支持 Microsoft .NET Framework 3.0。

版本信息

.NET Framework

受以下版本支持：3.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

SqlCeConnection 成员
System.Data.SqlServerCe 命名空间
SqlCeDataAdapter
SqlCeCommand