共用方式為

  • 發行項

Attribute 物件 (模型設計師)

Attribute 物件會定義實體中的一個項目。 此物件也會從 Field 物件繼承屬性。

屬性

名稱

基數

類型

描述

Name

1

String

項目的名稱。 請注意，如果屬性沒有運算式，這會是必要的字串。

DataType

1

DataTypeEnum

屬性的資料類型。 如果有運算式，則 DataType 值必須符合運算式的 DataType 值。

Nullable

0-1

Boolean

指出屬性是否可以有 Null 值。

Expression

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 格式之外，也支援下列格式字串：

資料整數的格式字串

  • ddd：週中的日縮寫

  • dddd：週中的日之完整名稱

  • MMM：月份縮寫

  • MMMM：完整的月份

布林的格式字串

  • truefalse：「True」與「False」

  • yesno：「是」與「否」

布林值的自訂格式字串

自訂格式字串的格式為 "truevalue;falsevalue"。

  • true：「True」

  • false：「False」

  • yes：「是」

  • no：「否」

  • " 和 '。 以單引號或雙引號括住的字元會直接複製到結果字串，不會影響格式化。

  • \ 逸出字元。 跟在指定之逸出字元後面的字元會視為常值字元，而不是格式規範。

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

指出計算此屬性的運算式時，不應加入安全性篩選。 通常是用在必須根據安全性篩選保護詳細資料，但是彙總資料是公用的情況。 當此屬性 (Attribute) 沒有運算式時，會忽略這個屬性 (Property)。

DefaultAggregateAttributeID

0-1

String

這個屬性之預設彙總的屬性識別碼， 這個字串必須是這個屬性之變數的識別碼； 如果 IsAggregate 為 True，將不允許這個字串。 如果隱藏屬性，就會忽略這個值。

ValueSelection

0-1

Enum

根據唯一值的預期數目，決定選取屬性值的用戶端應用程式行為。 有三個選項可用：None、Dropdown 和 List。 預設會選取 None，這個值需要使用者輸入值。 若是指定 Dropdown，會在簡單下拉式清單中顯示唯一的值。 若是指定 List，會在 UI 中以清單形式顯示唯一的值。 如果 IsAggregate 為 True，會忽略這個屬性。

Binding

0-1

Object

表示這個欄位的資料庫物件。 此屬性若沒有運算式，將需要這個物件。 繫結必須繫結到包含實體所繫結之資料表中的資料行，或者繫結到實體所繫結的資料行。

備註

  • 在報表產生器中，屬性稱為欄位。

  • 若要避免從值選取介面 (如 [篩選資料] 對話方塊或參數區域) 中擷取欄位的所有唯一值，請務必將 ValueSelection 屬性設定為 None。 使用者將需要輸入值。

  • 當使用可傳回 Null 的函數時，您必須將此屬性 (Attribute) 的 Nullable 屬性 (Property) 設定為 True。

  • 當 ValueSelection 屬性設定為 List 時，所有的值都會以排序清單的形式顯示給「報表產生器」使用者。 但是，當建立提示的篩選條件時，值的參數清單可能不會排序，因為語意查詢不會針對參數值查詢執行排序。 如果您的參數值清單未排序，而您想要排序它，請嘗試在基礎資料庫的欄位上建立索引，這樣做通常會排序此清單。

  • 若要在「報表產生器」報表配置中加入欄位時，於實體 (而非欄位) 上建立群組，您可以針對此欄位將 DiscourageGrouping 屬性設定為 True。 只有唯一的屬性 (Attribute) 才應該將這個屬性 (Property) 設定為 True。

如需有關有效列舉值的詳細資訊，請參閱＜模型設計師資料類型＞。