共用方式為


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 發生於 .NET Compact Framework Data Provider for SQL Server 傳送警告或參考用訊息時。
公用事件 StateChange 發生於連接的狀態變更時。 (覆寫 DbConnection.StateChange。)

上層

明確 繼承 實作

  名稱 說明
明確介面實作私用方法 IDbConnection.BeginTransaction() (繼承自 DbConnection)
明確介面實作私用方法 IDbConnection.BeginTransaction(IsolationLevel) (繼承自 DbConnection)
明確介面實作私用方法 IDbConnection.CreateCommand (繼承自 DbConnection)

上層

備註

SqlCeConnection 物件,代表與資料來源的唯一連接。當您建立 SqlCeConnection 的執行個體時,所有的屬性都會設定為初始值。如需這些值的清單,請參閱 SqlCeConnection 建構函式 (Constructor)。

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

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

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

範例

下列範例會建立 SqlCeCommand 和 SqlCeConnection。SqlCeConnection 會開啟,並設定為 SqlCeCommandConnection。該範例接著會呼叫 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 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。

請參閱

參考

System.Data.SqlServerCe 命名空間

SqlCeDataAdapter

SqlCeCommand