Attribute 对象(模型设计器)

更新日期: 2006 年 7 月 17 日

Attribute 对象定义实体中的项。此对象还从 Field 对象继承属性。

属性

名称 基数 类型 说明

Name

1

String

项的名称。注意,如果属性没有 Expression,则此属性为必需字符串。

DataType

1

DataTypeEnum

属性的数据类型。如果存在表达式,则 DataType 值必须与表达式的 DataType 值相匹配。

Nullable

0-1

Boolean

指示属性是否可以具有空值。

表达式

0-1

Object

用于计算属性值的表达式。必须返回标量值。

SortDirection

0-1

Enum

对此属性进行排序时所使用的默认排序方向。默认情况下,指定为升序。

Width

0-1

Integer

用于显示属性的默认列宽(字符)。该值必须大于 0。默认值基于 DataType 并且为下列值:Boolean:6、DateTime:10、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 格式之外,还支持下列格式字符串:

日期整数值的格式字符串

  • ddd:星期几的缩写
  • dddd:星期几的全名
  • MMM:月份的缩写
  • MMMM:月份的全名

布尔值的格式字符串

  • truefalse:“True”和“False”
  • yesno:“Yes”和“No”

布尔值的自定义格式字符串

自定义格式字符串采用“truevalue;falsevalue”格式。

  • true:“True”
  • false:“False”
  • yes:“Yes”
  • no:“No”
  • " 和 ':用单引号或双引号引起来的字符将按原样复制到结果字符串中,并且不影响格式。
  • \ 转义符 - 指定转义符字符后面的字符将视为文字字符,而不是格式说明符。

ContextualName

0-1

Enum

定义使用角色访问实体时客户端应用程序如何为此属性生成上下文相关名称。枚举器可以为以下三个值之一:AttributeMergeRole。枚举器值默认为 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。如果 IsAggregateTrue,则不允许使用此字符串。如果隐藏了该属性,则将忽略此值。

ValueSelection

0-1

Enum

根据所需的唯一值的数量,确定客户端应用程序在选择属性值时的行为。可以使用以下三个选项:NoneDropdownList。默认情况下选择“None”,需要用户键入值。如果指定 Dropdown,则将在简单下拉列表中显示唯一值。如果指定 List,则唯一值将在用户界面中显示为列表。如果 IsAggregateTrue,则将忽略此属性。

Binding

0-1

Object

表示此字段的数据库对象。如果属性不具有表达式,则此对象是必需的。Binding 必须绑定到表中包含实体所绑定的列或实体所绑定的列。

备注

  • 在报表生成器中,属性被称为字段。
  • 为防止无法在值选择界面(例如:“筛选数据”对话框或参数区域)中检索字段的所有唯一值,请确保将 ValueSelection 属性设置为 None。将要求用户键入一个值。
  • 如果使用的函数可返回 Null,则必须将该特性的 Nullable 属性设置为 True
  • 如果 ValueSelection 属性设置为 List,则所有值都以已排序列表的形式显示给报表生成器用户。然而,如果创建了某个提示筛选条件,由于语义查询不对参数值查询执行排序,因而参数值列表可能没有排序。如果参数值列表没有排序并且您希望对其进行排序,则请在基础数据库中对该字段创建索引;这样通常可以得到经过排序的列表。
  • 在向报表生成器报表布局添加字段时,若要对实体创建组而不是对字段创建组,可将字段的 DiscourageGrouping 属性设置为 True。仅对于唯一属性才应将该属性设置为 true。

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

请参阅

概念

模型设计器
模型设计器对象属性
使用报表模型即席生成报表
使用模型设计器

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

2006 年 7 月 17 日

新增内容:
  • 备注:控制字段的唯一实例。

2006 年 4 月 14 日

新增内容:
  • 在“备注”部分中添加了内容。