EntityType 元素 (CSDL)

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

  • 唯一名称。(必需)。

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

  • 用于包含数据的属性。(可选)。

  • 导航属性,用于从关联的一端导航至另一端。(可选)。

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

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

EntityType 元素可以具有以下子元素(按所列顺序):

适用的特性

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

特性名称

是否必需

Value

Name

实体类型的名称。

BaseType

实体类型的名称,该实体类型是所定义的另一个实体类型的基类型。

Abstract

True 或 False,具体取决于实体类型是否为抽象类型。

OpenType

True 或 False,具体取决于实体类型是否为开放实体类型。

注意注意
OpenType 特性仅适用于与 WCF 数据服务 一起使用的概念模型中定义的实体类型。

备注

可以将任何数量的批注特性(自定义 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 实体数据模型工具