EntityConnection 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 EntityConnection 類別的新執行個體。
多載
| 名稱 | Description |
|---|---|
| EntityConnection() |
初始化 EntityConnection 類別的新執行個體。 |
| EntityConnection(String) |
根據 連接字串 初始化 EntityConnection 類別的新實例。 |
| EntityConnection(MetadataWorkspace, DbConnection) |
初始化該類別的新實例 EntityConnection ，並指定 MetadataWorkspaceDbConnection和 。 |
備註
為避免無意中將 和 System.Data.Common.CommandTreesObjectContext 等物件與其元資料不同步，必須 EntityConnection 鎖定其元資料。 在元資料被鎖定後，連接字串 不允許更改。 以下是兩種中繼資料被鎖定的情況：
EntityConnection 實例可透過無參數建構子，或透過接受連接字串的 EntityConnection(String) 建構子構造。 無論哪種情況，連接字串 在開啟連線前都可能被多次更改。 呼叫 Open 或 GetMetadataWorkspace 鎖定元資料。
EntityConnection該實例是透過EntityConnection(MetadataWorkspace, DbConnection)構造子構造的，該構造子接受 a MetadataWorkspace 和 aDbConnection。 此時元資料在建置時被鎖定。 連接字串 永遠不允許更改。
當載入元資料時，會 EntityConnection 驗證概念模型、儲存模型與映射檔案的全部存在。
關於程式碼範例，請參見 「與 EntityClient 合作」。
EntityConnection()
初始化 EntityConnection 類別的新執行個體。
public:
EntityConnection();public EntityConnection();Public Sub New ()備註
為避免無意中將 和 System.Data.Common.CommandTreesObjectContext 等物件與其元資料不同步，必須 EntityConnection 鎖定其元資料。 在元資料被鎖定後，連接字串 不允許更改。 以下是兩種中繼資料被鎖定的情況：
EntityConnection 實例可透過無參數建構子，或透過接受連接字串的 EntityConnection(String) 建構子構造。 無論哪種情況，連接字串 在開啟連線前都可能被多次更改。 呼叫 Open 或 GetMetadataWorkspace 鎖定元資料。
EntityConnection該實例是透過EntityConnection(MetadataWorkspace, DbConnection)構造子構造的，該構造子接受 a MetadataWorkspace 和 aDbConnection。 此時元資料在建置時被鎖定。 連接字串 永遠不允許更改。
當載入元資料時，會 EntityConnection 驗證概念模型、儲存模型與映射檔案的全部存在。
關於程式碼範例，請參見 「與 EntityClient 合作」。
適用於
EntityConnection(String)
根據 連接字串 初始化 EntityConnection 類別的新實例。
public:
EntityConnection(System::String ^ connectionString);public EntityConnection(string connectionString);new System.Data.EntityClient.EntityConnection : string -> System.Data.EntityClient.EntityConnectionPublic Sub New (connectionString As String)參數
- connectionString
- String
提供者專用的 連接字串。
例外狀況
提供無效的 連接字串 關鍵字，或未提供必要的 連接字串 關鍵字。
備註
Entity Data Model 工具 會產生一個命名的 連接字串，並儲存在應用程式的設定檔中。 這個命名連接字串可以在實例化 EntityConnection 類別時，取代 connectionString 參數。
為避免不小心放置物件 System.Data.Common.CommandTrees 且 ObjectContext 與其元資料不同步，必須 EntityConnection 鎖定其元資料。 在元資料被鎖定後，連接字串 不允許更改。 以下是兩種中繼資料被鎖定的情況：
EntityConnection 實例是透過無參數建構子，或透過此建構子（EntityConnection(String)）構造，該建構子接受一個連接字串。 無論哪種情況，連接字串 在開啟連線前都可能被多次更改。 呼叫 Open 或 GetMetadataWorkspace 鎖定元資料。
EntityConnection該實例是透過EntityConnection(MetadataWorkspace, DbConnection)構造子構造的，該構造子接受 a MetadataWorkspace 和 aDbConnection。 此時元資料在建置時被鎖定。 連接字串 永遠不允許更改。
當載入元資料時，會 EntityConnection 驗證概念模型、儲存模型與映射檔案的全部存在。
關於程式碼範例，請參見 「與 EntityClient 合作」。
適用於
EntityConnection(MetadataWorkspace, DbConnection)
初始化該類別的新實例 EntityConnection ，並指定 MetadataWorkspaceDbConnection和 。
public:
EntityConnection(System::Data::Metadata::Edm::MetadataWorkspace ^ workspace, System::Data::Common::DbConnection ^ connection);public EntityConnection(System.Data.Metadata.Edm.MetadataWorkspace workspace, System.Data.Common.DbConnection connection);new System.Data.EntityClient.EntityConnection : System.Data.Metadata.Edm.MetadataWorkspace * System.Data.Common.DbConnection -> System.Data.EntityClient.EntityConnectionPublic Sub New (workspace As MetadataWorkspace, connection As DbConnection)參數
- workspace
- MetadataWorkspace
MetadataWorkspace A 與此EntityConnection相關聯。
- connection
- DbConnection
這個物件的 EntityConnection 底層資料來源連線。
例外狀況
workspace或connection參數為 null。
connection 並非來自 ADO.NET Entity Framework 相容的提供者。
備註
這個建構器讓你能建立 EntityConnection 一個非來自磁碟檔案或組件中嵌入資源的 from（來源）元資料。
為避免不小心將 和 System.Data.Common.CommandTreesObjectContext 等物件與其元資料不同步，必須 EntityConnection 鎖定其元資料。 在元資料被鎖定後，連接字串 不允許更改。 以下是兩種中繼資料被鎖定的情況：
EntityConnection 實例可透過無參數建構子，或透過接受連接字串的 EntityConnection(String) 建構子構造。 無論哪種情況，連接字串 在開啟連線前都可能被多次更改。 呼叫 Open 或 GetMetadataWorkspace 鎖定元資料。
EntityConnection該實例透過此構造子（），EntityConnection(MetadataWorkspace, DbConnection)該構造子接受 a MetadataWorkspace 與 aDbConnection。 此時元資料在建置時被鎖定。 連接字串 永遠不允許更改。
當載入元資料時，會 EntityConnection 驗證概念模型、儲存模型與映射檔案的全部存在。