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.CommandTreesObjectContext 等物件與其元資料不同步，必須 EntityConnection 鎖定其元資料。 在元資料被鎖定後，連接字串 不允許更改。 以下是兩種中繼資料被鎖定的情況：

• EntityConnection 實例可透過無參數建構子，或透過接受連接字串的 EntityConnection(String) 建構子構造。 無論哪種情況，連接字串 在開啟連線前都可能被多次更改。 呼叫 Open 或 GetMetadataWorkspace 鎖定元資料。

• EntityConnection該實例是透過EntityConnection(MetadataWorkspace, DbConnection)構造子構造的，該構造子接受 a MetadataWorkspace 和 aDbConnection。 在這種情況下，元資料會在建構時被鎖定。 連接字串 永遠不允許更改。

當載入元資料時，會 EntityConnection 驗證概念模型、儲存模型與映射檔案的全部存在。

關於程式碼範例，請參見 「與 EntityClient 合作」。

建構函式

名稱	Description
EntityConnection()	初始化 EntityConnection 類別的新執行個體。
EntityConnection(MetadataWorkspace, DbConnection)	初始化該類別的新實例 EntityConnection ，並指定 MetadataWorkspaceDbConnection和 。
EntityConnection(String)	根據 連接字串 初始化 EntityConnection 類別的新實例。

屬性

名稱	Description
CanRaiseEvents	會得到一個值，表示該元件是否能引發事件。 (繼承來源 Component)
ConnectionString	取得或設定 EntityConnection 連接字串。
ConnectionTimeout	嘗試建立連線時，會獲得等待的秒數，然後結束嘗試並產生錯誤。
Container	得到 IContainer 包含 Component的 。 (繼承來源 Component)
Database	取得目前資料庫名稱，或連線開啟後將使用的資料庫名稱。
DataSource	取得要連接的資料來源名稱或網路位址。
DbProviderFactory	為此DbProviderFactory付出DbConnection代價。 (繼承來源 DbConnection)
DesignMode	會得到一個值，表示目前 Component 是否處於設計模式。 (繼承來源 Component)
Events	會取得與此 Component連結的事件處理程序清單。 (繼承來源 Component)
ServerVersion	取得一個字串，包含用戶端所連接的資料來源版本。
Site	取得或設定 ISite 的 Component。 (繼承來源 Component)
State	如果 是EntityConnection開放的，則取得ConnectionState底層提供者的屬性。 否則傳回 Closed。
StoreConnection	提供物件所使用的 EntityConnection 底層資料來源連線存取。

方法

名稱	Description
BeginDbTransaction(IsolationLevel)	當在派生類別中被覆寫時，會啟動資料庫交易。 (繼承來源 DbConnection)
BeginTransaction()	透過使用底層提供者開始交易。
BeginTransaction(IsolationLevel)	利用底層提供者以指定的隔離層級開始交易。
ChangeDatabase(String)	不支援。
Close()	關閉了與資料庫的連線。
CreateCommand()	建立一個新的實例 EntityCommand，集合為 ConnectionEntityConnection。
CreateDbCommand()	當在衍生類別中覆寫時，會建立並回傳 DbCommand 與目前連線相關的物件。 (繼承來源 DbConnection)
CreateObjRef(Type)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
EnlistTransaction(Transaction)	將此 EntityConnection 列入指定的交易中。
Equals(Object)	判斷指定的 物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	取得目前控制此實例生命週期政策的終身服務物件。 (繼承來源 MarshalByRefObject)
GetMetadataWorkspace()	回傳 MetadataWorkspace 與此 EntityConnection相關的 。
GetSchema()	回傳此 DbConnection資料來源的結構資訊。 (繼承來源 DbConnection)
GetSchema(String, String[])	回傳此 DbConnection 資料來源的結構資訊，並使用指定的字串作為結構名稱，並以指定的字串陣列作為限制值。 (繼承來源 DbConnection)
GetSchema(String)	會使用指定的字串作為結構名稱，回傳該 DbConnection 資料庫的結構資訊。 (繼承來源 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。 此方法會呼叫 CancellationToken.None 的虛擬方法 OpenAsync(CancellationToken) 。 (繼承來源 DbConnection)
OpenAsync(CancellationToken)	這是非同步版本的 Open()。 提供者應該透過適當的實作來覆蓋。 取消代幣可選擇性地被承認。 預設實作會 Open() 呼叫同步呼叫並回傳已完成的任務。 預設實作若傳遞已取消的取消令牌，會回傳已取消的任務。 由 Open 拋出的異常會透過回傳的任務異常屬性來傳達。 在回傳任務完成前，不要呼叫物件的其他 DbConnection 方法和屬性。 (繼承來源 DbConnection)
ToString()	回傳 String 包含 的名稱 Component（若有的話）。 此方法不應被覆蓋。 (繼承來源 Component)

事件

名稱	Description
Disposed	當元件被呼叫方法 Dispose() 時會發生。 (繼承來源 Component)
StateChange	當連線狀態改變時會發生。 (繼承來源 DbConnection)

明確介面實作

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

另請參閱

• EntityClient Provider for Entity Framework
• 連接字串