EntityType 元素 (CSDL)

EntityType 元素表示概念模型中顶级概念（例如客户或订单）的结构。 实体类型是应用程序中实体类型实例的模板。 每个模板都包含以下信息：

• 唯一名称。 （必需）。

• 由一个或多个属性定义的实体键。 （必需）。

• 用于包含数据的属性。 （可选）。

• 导航属性，用于从关联的一端导航至另一端。 （可选）。

在应用程序中，实体类型的实例表示一个特定对象（例如特定客户或订单）。 实体类型的每个实例在实体集中都必须具有唯一的实体键。

只有两个实体类型实例的类型相同且其实体键的值也相同时，才认为它们是相等的。

EntityType 元素可以具有以下子元素（按所列顺序）：

• Documentation（零个或一个元素）

• Key（零或一个元素）

• Property（零个或多个元素）

• NavigationProperty（零个或多个元素）

• 批注元素（零个或多个元素）

适用的特性

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

特性名称	是否必需	值
Name	是	实体类型的名称。
BaseType	否	实体类型的名称，该实体类型是所定义的另一个实体类型的基类型。
Abstract	否	True 或 False，具体取决于实体类型是否为抽象类型。
OpenType	否	True 或 False，具体取决于实体类型是否为开放实体类型。 注意： OpenType 特性仅适用于与 ADO.NET Data Services 一起使用的概念模型中定义的实体类型。

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

示例

下面的示例显示 EntityType 元素，该元素具有三个 Property 元素和两个 NavigationProperty 元素：

<EntityType Name="Book">
  <Key>
    <PropertyRef Name="ISBN" />
  </Key>
  <Property Type="String" Name="ISBN" Nullable="false" />
  <Property Type="String" Name="Title" Nullable="false" />
  <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
  <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
                      FromRole="Book" ToRole="Publisher" />
  <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
                      FromRole="Book" ToRole="Author" />
</EntityType>

另请参见

概念

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

其他资源

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