EntityContainer 元素 (CSDL)

以概念架构定义语言 (CSDL) 表示的 EntityContainer 元素是一种用于容纳实体集、关联集和函数导入的逻辑容器。 概念模型实体容器通过 EntityContainerMapping 元素映射到存储模型实体容器。 存储模型实体容器描述数据库的结构：实体集描述表、关联集描述外键约束、函数导入描述数据库中的存储过程。 有关更多信息，请参见 EntityContainer 元素 (SSDL)。

EntityContainer 元素可以具有零个或一个 Documentation 元素。 如果存在 Documentation 元素，则该元素必须在所有 EntitySet、AssociationSet 和 FunctionImport 元素前面。

EntityContainer 元素可以具有零个或多个下列子元素（按所列顺序）：

• EntitySet

• AssociationSet

• FunctionImport

• 批注元素

可以扩展 EntityContainer 元素以将同一命名空间中另一个元素 EntityContainer 的内容包含在内。 若要包含另一个元素 EntityContainer 的内容，请在引用 EntityContainer 元素中将 Extends 特性的值设置为要包含的 EntityContainer 元素的名称。 所包含的 EntityContainer 元素的所有子元素都将被视为引用 EntityContainer 元素的子元素。

适用的特性

下表介绍可应用于 Using 元素的特性。

特性名称	是否必需	值
Name	是	实体容器的名称。
Extends	否	同一命名空间中另一实体容器的名称。 （有关命名空间的更多信息，请参见 Schema 元素 (CSDL)）。

注意：
可以将任何数量的批注特性（自定义 XML 特性）应用于 EntityContainer 元素。然而，自定义特性可能不属于为 CSDL 保留的任何 XML 命名空间。任何两个自定义特性的完全限定名称都不能相同。

示例

以下示例显示一个 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>

另请参见

概念

实体框架概述
CSDL 规范
Schema 元素 (CSDL)

其他资源

CSDL、SSDL 和 MSL 规范
ADO.NET Entity Data Model Tools
entity container (Entity Data Model)