EntityContainer 項目 (CSDL)

發行項
12/10/2012

概念結構定義語言 (CSDL) 中的 EntityContainer 項目是實體集、關聯集和函式匯入的邏輯容器。概念模型實體容器透過 EntityContainerMapping 項目對應於儲存體模型實體容器。儲存體模型實體容器描述資料的結構：實體集描述資料表、關聯集描述外部索引建條件約束，而函式匯入則描述資料庫中的預存程序。如需詳細資訊，請參閱 EntityContainer 項目 (SSDL)。

一個 EntityContainer 項目可以有零個或一個 Documentation 項目。如果有 Documentation 項目，此項目必須在所有 EntitySet、AssociationSet 和 FunctionImport 項目前面。

一個 EntityContainer 項目可以有零個以上的下列子項目 (依列出的順序)：

您可以延伸 EntityContainer 項目，以包含相同命名空間內另一個 EntityContainer 的內容。若要包含另一個 EntityContainer 的內容，在參考 EntityContainer 項目中，將 Extends 屬性的值設為您要包含之 EntityContainer 項目的名稱。系統會將被包含之 EntityContainer 項目中的所有子項目視為參考 EntityContainer 項目的子項目。

適用屬性

下表描述可套用至 Using 項目的屬性。

屬性名稱	必要	值
Name	是	實體容器的名稱。
Extends	否	相同命名空間中另一個實體容器的名稱。(如需命名空間的詳細資訊，請參閱Schema 項目 (CSDL))。

注意

可以將任何數量的註釋屬性 (自訂 XML 屬性) 套用至 EntityContainer 項目。不過，自訂屬性不可屬於任何 XML 命名空間，這是保留供 CSDL 使用。任兩個自訂屬性的完整名稱不能相同。

範例

下列範例顯示 EntityContainer 項目，此項目會定義三個實體集和兩個關聯集。

<EntityContainer Name="BooksContainer" >
  <EntitySet Name="Books" EntityType="BooksModel.Book" />
  <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
  <EntitySet Name="Authors" EntityType="BooksModel.Author" />
  <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
    <End Role="Book" EntitySet="Books" />
    <End Role="Publisher" EntitySet="Publishers" />
  </AssociationSet>
  <AssociationSet Name="WrittenBy" Association="BooksModel.WrittenBy">
    <End Role="Book" EntitySet="Books" />
    <End Role="Author" EntitySet="Authors" />
  </AssociationSet>
</EntityContainer>