Attribute 对象（模型设计器）
Attribute 对象定义实体中的项。此对象还从 Field 对象继承属性。
属性
名称 |
基数 |
类型 |
说明 |
|---|---|---|---|
Name |
1 |
String |
项的名称。注意，如果属性没有 Expression，则此属性为必需字符串。 |
DataType |
1 |
DataTypeEnum |
属性的数据类型。如果存在表达式，则 DataType 值必须与表达式的 DataType 值相匹配。 |
Nullable |
0-1 |
Boolean |
指示属性是否可以具有 Null 值。 |
0-1 |
Object |
用于计算属性值的表达式。必须返回标量值。 |
|
SortDirection |
0-1 |
Enum |
对此属性进行排序时所使用的默认排序方向。默认情况下，指定为升序。 |
Width |
0-1 |
Integer |
用于显示属性的默认列宽（字符）。该值必须大于 0。默认值基于 DataType，并且为下列值：Boolean：6、DateTime：10、Time：8、Integer：8、Decimal：8、Float：8、String：20、Binary：1023、EntityKey：128。 |
Alignment |
0-1 |
Enum |
默认字符对齐方式。默认值为“常规”。其他可能的值为“左对齐”、“居中”或“右对齐”。 |
MimeType |
0-1 |
String |
属性的 MIME 类型。对于非二进制属性，将忽略此值。不能指定空字符串。 |
DataCulture |
0-1 |
Language |
指示为区分区域性的操作使用的区域性；例如，使用货币符号设置数字数据的格式。此区域性属性并不用于简单显示格式，如日期或数字格式。如果未指定，则 DataCulture 的默认值为 Model.Culture 中使用的模型的区域性值。 |
DiscourageGrouping |
0-1 |
Boolean |
指示客户端应用程序是否禁止用户按此属性进行分组。应该对具有唯一值的字段设置 DiscourageGrouping，例如电话号码。如果该属性为实体的键属性或标识属性，则客户端应用程序将改为按实体的键属性进行分组。 |
EnableDrillthrough |
0-1 |
Boolean |
指示客户端应用程序是否提供从此属性至包含实体的钻取链接。 |
Format |
0-1 |
String |
指定用于设置属性值格式的默认 .NET Framework 格式字符串。除了标准 .NET Framework 格式之外，还支持下列格式字符串： 日期整数值的格式字符串
布尔值的格式字符串
布尔值的自定义格式字符串 自定义格式字符串采用“truevalue;falsevalue”格式。
|
ContextualName |
0-1 |
Enum |
定义使用角色访问实体时客户端应用程序如何为此属性生成上下文相关名称。枚举器可以为以下三个值之一：Attribute、Merge 或 Role。枚举器值默认为 Attribute，它使用属性名作为上下文名称。指定 Merge 将合并属性名和角色名作为上下文名称。如果此属性是实体的唯一标识属性，则指定 Role 会将角色名用作上下文名称。如果它不是实体的唯一标识属性，则 Role 的处理方式与 Merge 相同。 |
IsAggregate |
0-1 |
Boolean |
指示此属性是否为聚合，该聚合不仅可以在包含实体的上下文中进行计算，而且可以在包含实体中存在一对多关系的任何其他实体的上下文中进行计算。如果未设置此属性，则会将属性视为标量。对于带有非定位表达式的属性，IsAggregate 只能为 True。 |
IsFilter |
0-1 |
Boolean |
指示此属性适用于用作命名筛选器。对于布尔值属性，只能为 True。 |
OmitSecurityFilters |
0-1 |
Boolean |
指示应在不添加安全筛选器的情况下计算此属性的表达式。通常用于必须基于安全筛选器来保护详细信息数据但聚合数据为公共数据的情况。如果特性不具有表达式，则将忽略此属性。 |
DefaultAggregateAttributeID |
0-1 |
String |
作为此属性默认聚合的属性的 ID。此字符串必须是此属性的变体的 ID。如果 IsAggregate 为 True，则不允许使用此字符串。如果隐藏了该属性，则将忽略此值。 |
ValueSelection |
0-1 |
Enum |
根据所需的唯一值的数量，确定客户端应用程序在选择属性值时的行为。可以使用以下三个选项：None、Dropdown 和 List。默认情况下选择“None”，需要用户键入值。如果指定 Dropdown，则将在简单下拉列表中显示唯一值。如果指定 List，则唯一值将在用户界面中显示为列表。如果 IsAggregate 为 True，则将忽略此属性。 |
0-1 |
Object |
表示此字段的数据库对象。如果属性不具有表达式，则此对象是必需的。Binding 必须绑定到表中包含实体所绑定的列或实体所绑定的列。 |
注释
在报表模型中，属性被称为字段。
为防止在值选择界面（例如：“筛选数据”对话框或参数区域）中检索字段的所有唯一值，请确保将 ValueSelection 属性设置为 None。将要求用户键入一个值。
如果使用的函数可返回 Null，则必须将该特性的 Nullable 属性设置为 True。
如果 ValueSelection 属性设置为 List，则所有值都以已排序列表的形式显示给用户。然而，如果创建了某个提示筛选条件，由于语义查询不对参数值查询执行排序，因而参数值列表可能没有排序。如果参数值列表没有排序并且您希望对其进行排序，则请在基础数据库中对该字段创建索引；这样通常可以得到经过排序的列表。
对实体而非字段创建组。