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 超出範圍，就不會關閉。您必須呼叫 Close 或 Dispose 來明確地關閉連接。

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

如果嚴重的 SqlCeException 是由執行 SqlCeCommand 的方法所產生，則 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 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。

請參閱

參考

System.Data.SqlServerCe 命名空間

SqlCeDataAdapter

SqlCeCommand