SqlCeConnection Class

表示 SQL Server Compact 3.5 資料來源的開啟連接。

命名空間: System.Data.SqlServerCe
組件: System.Data.SqlServerCe (在 system.data.sqlserverce.dll)

語法

'宣告
Public NotInheritable Class SqlCeConnection
    Inherits DbConnection

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 建構函式 (Constructor)。

如果 SqlCeConnection 超出範圍，就不會關閉。您必須呼叫 Close 或 Dispose 來明確地關閉連接。

SQL Server Compact 3.5 可同時支援多個連接，並支援共用相同連接的多個命令。這表示在同一個連接上可以開啟 SqlCeDataReader 的多個執行個體。這項行為與 System.Data.SqlClient 的不同。

如果嚴重的 SqlCeException 是由執行 SqlCeCommand 的方法所產生，則 SqlCeConnection 可能已關閉。您可以重新開啟連接並繼續。

SQL Server Compact 3.5 目前並未最佳化，無法當做網站的資料庫。根據預設，SQL Server Compact 3.5 會封鎖從 ASP.NET 連接之應用程式所做的連接。SQL Server Compact 3.5 已最佳化，可以當做應用程式中的內嵌資料庫使用。使用 SQL Server Compact 3.5 當做網站的資料庫需要支援多位使用者和並行資料變更。如此可能會造成效能上的問題。因此，不支援這些案例。其他版本的 SQL Server (包括 SQL Server Express) 已最佳化，可以當做網站的資料庫。

SQL Server Compact 3.5 可以在使用 ASP.NET 建立 SQL Server Compact 3.5 資料庫 (適用於同步處理案例) 的應用程式案例中搭配 ASP.NET 使用。使用下列程式碼以變更 SQL Server Compact 3.5 的預設行為，以便在 ASP.NET 中運作。

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

繼承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.SqlServerCe.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) 此型別的成員具備執行緒安全。不保證任何執行個體成員安全執行緒。

平台

開發平台

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
版本資訊
.NET Framework 及 NET Compact Framework
支援於 3.5
.NET Framework
支援於 3.0
.NET Compact Framework 及 .Net Framework
支援於 2.0

另請參閱

參考

SqlCeConnection Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeCommand Class