通过

  • 项目

Role 对象（模型设计器）

Role 对象定义实体的角色。角色是对两个相关实体的说明。此对象从 Field 对象继承属性。

属性

名称

基数

类型

说明

Name

0-1

String

角色的名称。如果 Cardinality 为 One 或 OptionalOne，则相关实体的 Name 为默认值。否则，字符串值默认为相关实体的 CollectionName。

Linguistics

0-1

Object

角色的 Linguistics 属性。如果未提供 Name，则不允许使用此元素。在这种情况下，SingularName 和 PluralName 分别默认为相关实体的 Name 和 Collection。

RelatedRoleID

1

String

目标实体的相应角色的 ID。此角色不能为 RelatedRole。此外，RelatedRole 的 RelatedRole 必须为此角色。

Cardinality

1

Enum

有四个选项：One、Many、OptionalOne、OptionalMany。

ContextualName

0-1

Enum

用角色来访问实体时，ContextualName 枚举器将覆盖该角色的目标实体中属性的 ContextualName 设置。枚举器可以为以下三个值之一：Attribute、Merge 或 Role。枚举器值默认为 Attribute，它使用属性名作为上下文名称。指定 Merge 将合并属性名和角色名作为上下文名称。如果此属性是实体的唯一标识属性，则指定 Role 会将角色名称用作上下文名称。如果它不是实体的唯一标识属性，则对 Role 的处理方式与 Merge 相同。

HiddenFields

0-1

Object

一组字段和字段文件夹，在用角色来访问实体时，客户端应用程序不应为角色的目标实体显示这些字段和字段文件夹。例如，在使用 HomeAddress 角色显示 Address 时，AddressType 属性应当是隐藏的。

ExpandInline

0-1

Boolean

指示客户端应用程序不应向用户显示角色，而应显示相关实体的字段，就好像这些字段是此实体的一部分一样。如果同时指定了角色扩展和查找行为，则前者优先。

PromoteLookup

0-1

Boolean

指示当包含实体显示为查找实体时，客户端应用程序也会将目标实体显示为查找实体。只有当角色的包含实体和目标实体都是查找实体时，才允许设置此值。如果 PromoteLookup 的值为 True，并且所提升角色的相关实体不是角色将提升为的目标实体，也不是其直接祖先或后代之一，则系统将提升查找角色的相关实体上的查找角色。

Preferred

0-1

Boolean

指示包含此角色的路径应当优先于不包含首选角色的路径。使用此布尔值可以指示如果有多个路径可供选择，则应当用哪个路径来访问另一个实体。

Recursion

0-1

Boolean

指示默认情况下是否应对关系进行递归遍历。只有当包含实体与目标实体相同时，才允许进行递归。角色将递归展开，但是，如果试图将实体 A 中的项扩展到 A 的上下文，或者它的一个直接祖先或后代，则递归将停止。

Binding

0-1

Object

表示此角色的数据库对象。请注意，关系的指定端必须与包含 RelatedRole 元素的实体所绑定的表中的列绑定，或等于实体所绑定的列。关系的另一端必须在此角色的包含实体所绑定的表中，或等于此实体所绑定的列。必须进行绑定，除非此角色的实体所绑定的表包含 RelatedRole 的实体所绑定的列（或者相反）。在这种情况下，列和表之间的包含关系是隐含的，因此不用指定绑定。

备注

在报表生成器中，角色是对两个实体之间的关系的说明。

有关有效的枚举值的详细信息，请参阅模型设计器数据类型。