EntityConnection.GetMetadataWorkspace 方法

定義

命名空間:

System.Data.EntityClient

組件:

System.Data.Entity.dll

重要

此 API 不符合 CLS 規範。

傳回與這個 MetadataWorkspace 相關聯的 EntityConnection。

public:
 System::Data::Metadata::Edm::MetadataWorkspace ^ GetMetadataWorkspace();

[System.CLSCompliant(false)]
public System.Data.Metadata.Edm.MetadataWorkspace GetMetadataWorkspace ();

[<System.CLSCompliant(false)>]
member this.GetMetadataWorkspace : unit -> System.Data.Metadata.Edm.MetadataWorkspace

Public Function GetMetadataWorkspace () As MetadataWorkspace

傳回

MetadataWorkspace

與這個 MetadataWorkspace 相關聯的 EntityConnection。

屬性

CLSCompliantAttribute

例外狀況

MetadataException

包含無效 Metadata 關鍵字值的內嵌連接字串。

備註

在 MetadataWorkspace 類別建立時，EntityConnection 也會自動建立。 此建立程序可能會擲回中繼資料特有的例外狀況。 中繼資料會載入記憶體中，而 Entity Data Model (EDM) 應用程式會使用該中繼資料來存取有關基礎資料來源的資訊。 如需詳細資訊，請參閱 ADO.NET 元數據。

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

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

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

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