SqlCeConnection 類別

發行項
01/17/2011

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

命名空間： 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 建構函式 (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)

範例

下列範例會建立 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();
}