EntityConnection 類別

定義

命名空間:

System.Data.EntityClient

組件:

System.Data.Entity.dll

包含概念模型的參考和資料來源連接。 此類別無法獲得繼承。

public ref class EntityConnection sealed : System::Data::Common::DbConnection

public sealed class EntityConnection : System.Data.Common.DbConnection

type EntityConnection = class
    inherit DbConnection

Public NotInheritable Class EntityConnection
Inherits DbConnection

繼承

Object

MarshalByRefObject

Component

DbConnection

EntityConnection

備註

若要避免不小心讓類似 System.Data.Common.CommandTrees 和 ObjectContext 等物件與其中繼資料未同步，EntityConnection 必須鎖定它的中繼資料。 當鎖定中繼資料以後，就不允許對連接字串做任何變更。 以下是鎖定中繼資料的兩個案例：

• 實例 EntityConnection 是透過無參數建構函式或接受連接字串的 EntityConnection(String) 建構函式來建構。 在任何一種情況下，連接字串都可能會在開啟連接之前變更多次。 呼叫 Open 或 GetMetadataWorkspace 會鎖定中繼資料。

• 透過可接受 EntityConnection 和 EntityConnection(MetadataWorkspace, DbConnection) 的 MetadataWorkspace 建構函式來建構 DbConnection 執行個體。 在此情況下，中繼資料會在建構時鎖定。 不允許對連接字串做任何變更。

當載入中繼資料時，EntityConnection 會驗證概念模型、儲存模型及對應檔是否都存在。

如需程式代碼範例，請參閱 使用 EntityClient。

建構函式

EntityConnection()	初始化 EntityConnection 類別的新執行個體。
EntityConnection(MetadataWorkspace, DbConnection)	使用指定的 EntityConnection 和 MetadataWorkspace 初始化 DbConnection 類別的新執行個體。
EntityConnection(String)	根據連接字串初始化 EntityConnection 類別的新執行個體。

屬性

CanCreateBatch	取得值，指出這個 DbConnection 執行個體是否支援 DbBatch 類別。 (繼承來源 DbConnection)
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
ConnectionString	取得或設定 EntityConnection 連接字串。
ConnectionTimeout	取得在結束嘗試並產生錯誤前嘗試建立連接的等候秒數。
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
Database	取得目前資料庫或在開啟連接後要使用之資料庫的名稱。
DataSource	取得要連接到的資料來源的名稱或網路地址。
DbProviderFactory	取得此 DbProviderFactory 的 DbConnection。 (繼承來源 DbConnection)
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
ServerVersion	取得包含用戶端所連接之資料來源版本的字串。
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
State	如果 ConnectionState 是開啟的，則取得基礎提供者的 EntityConnection 屬性， 否則傳回 Closed。
StoreConnection	提供基礎資料來源連接的存取 (EntityConnection 物件會使用該連接)。

方法

BeginDbTransaction(IsolationLevel)	當在衍生類別中被覆寫時，會開始進行資料庫交易。 (繼承來源 DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	以非同步方式開始資料庫交易。 (繼承來源 DbConnection)
BeginTransaction()	使用基礎提供者開始交易。
BeginTransaction(IsolationLevel)	使用基礎提供者開始具有指定之隔離等級的異動。
BeginTransactionAsync(CancellationToken)	以非同步方式開始資料庫交易。 (繼承來源 DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	以非同步方式開始資料庫交易。 (繼承來源 DbConnection)
ChangeDatabase(String)	不支援。
ChangeDatabaseAsync(String, CancellationToken)	以非同步方式針對開啟的連線變更目前的資料庫。 (繼承來源 DbConnection)
Close()	關閉與資料庫的連接。
CloseAsync()	以非同步方式關閉與資料庫的連線。 (繼承來源 DbConnection)
CreateBatch()	傳回提供者類別的新執行個體，該執行個體會實作 DbBatch 類別。 (繼承來源 DbConnection)
CreateCommand()	建立 EntityCommand 的新執行個體，且 Connection 設定為這個 EntityConnection。
CreateDbBatch()	在衍生類別中覆寫時，傳回實 DbBatch 作 類別之提供者類別的新實例。 (繼承來源 DbConnection)
CreateDbCommand()	當在衍生類別中被覆寫時，建立並傳回與目前連線相關聯的 DbCommand 物件。 (繼承來源 DbConnection)
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 DbConnection)
Dispose(Boolean)	釋放 DbConnection 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 DbConnection)
DisposeAsync()	以非同步方式處置連線物件。 (繼承來源 DbConnection)
EnlistTransaction(Transaction)	在指定的異動中登記這個 EntityConnection。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetMetadataWorkspace()	傳回與這個 MetadataWorkspace 相關聯的 EntityConnection。
GetSchema()	傳回這個 DbConnection 之資料來源的結構描述資訊。 (繼承來源 DbConnection)
GetSchema(String)	使用結構描述名稱的特定字串，傳回這個 DbConnection 之資料來源的結構描述資訊。 (繼承來源 DbConnection)
GetSchema(String, String[])	使用結構描述名稱的特定字串和限制值的特定字串陣列，傳回這個 DbConnection 的資料來源的結構描述資訊。 (繼承來源 DbConnection)
GetSchemaAsync(CancellationToken)	這是 GetSchema() 的非同步版本。 提供者應該覆寫為適當的實作。 您可以選擇性地接受 cancellationToken。 預設實作會叫用同步GetSchema()呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken，預設實作會傳回已取消的工作。 GetSchema() 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 (繼承來源 DbConnection)
GetSchemaAsync(String, CancellationToken)	這是 GetSchema(String) 的非同步版本。 提供者應該覆寫為適當的實作。 您可以選擇性地接受 cancellationToken。 預設實作會叫用同步GetSchema(String)呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken，預設實作會傳回已取消的工作。 GetSchema(String) 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 (繼承來源 DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	這是 GetSchema(String, String[]) 的非同步版本。 提供者應該覆寫為適當的實作。 您可以選擇性地接受 cancellationToken。 預設實作會叫用同步GetSchema(String, String[])呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken，預設實作會傳回已取消的工作。 GetSchema(String, String[]) 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 (繼承來源 DbConnection)
GetService(Type)	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	引發 StateChange 事件。 (繼承來源 DbConnection)
Open()	呼叫基礎資料提供者的 Open 方法，建立與資料來源的連接。
OpenAsync()	非同步版本的 Open()，這個版本會透過 ConnectionString 所指定的設定開啟資料庫連接。 這個方法會叫用虛擬方法 OpenAsync(CancellationToken) 與 CancellationToken.None。 (繼承來源 DbConnection)
OpenAsync(CancellationToken)	這是 Open() 的非同步版本。 提供者應該覆寫為適當的實作。 可以選擇性地接受取消語彙基元。 預設實作會叫用同步Open()呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken，預設實作會傳回已取消的工作。 Open 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 在傳回的工作完成之前，不叫用 DbConnection 物件的其他方法及屬性。 (繼承來源 DbConnection)
ToString()	傳回任何包含 Component 名稱的 String。 不應覆寫此方法。 (繼承來源 Component)

事件

Disposed	當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component)
StateChange	當連線的狀態變更時發生。 (繼承來源 DbConnection)

明確介面實作

IDbConnection.BeginTransaction()	開始資料庫異動。 (繼承來源 DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	使用指定的隔離等級開始資料庫異動。 (繼承來源 DbConnection)
IDbConnection.CreateCommand()	建立並傳回與目前連線相關聯的 DbCommand 物件。 (繼承來源 DbConnection)

另請參閱

• EntityClient Provider for Entity Framework
• 使用 EntityClient
• 連接字串