模型驅動應用程式中的欄位(客戶端 API 參考)

欄包含模型導向應用程式表單或方格中的資料。 使用 formContext.data.entity.attributes 集合或 formContext.getAttribute 快捷方式方法來存取資料行集合。 如需集合的詳細資訊,請參閱集合 (用戶端 API 參考)。

要存取集合中的欄位,將欄位名稱(字串)或索引值(編號)作為參數傳遞給方法。 例如: formContext.getAttribute(arg) 。 如果你沒有指定參數,方法會回傳表單上所有屬性的集合。

欄會依類型分類。 使用 getAttributeType 方法來判斷欄位的類型。 某些資料行方法僅適用於特定類型的資料行。

本文提供每種欄位類型可用的方法資訊。

所有資料行類型

控制屬性提供與該欄位相關的控制項集合。

以下方法適用於所有欄位類型:

Method Description
addOnChange 新增一個函式,當欄位事件發生時 OnChange 執行。
fireOnChange 觸發該欄位 OnChange 的事件。
get屬性類型 回傳欄位的類型。
get格式 回傳該欄的格式。
getIs骯髒 回傳欄位是否有未儲存的變更。
取得名稱 回傳欄位的邏輯名稱。
getParent 回傳父 formContext.data.entity 物件。
getRequiredLevel 回傳欄位值是否需要或建議。
get提交模式 當該欄位的資料在儲存時會回傳。
getUserPrivilege 回傳使用者建立、讀取或更新欄位值的權限。
get值 回傳欄位的資料值。
是有效 回傳該欄位值是否有效。
removeOnChange 移除欄位事件處理程序中的 OnChange 一個函式。
setIs有效 設定欄位的有效性及錯誤訊息。
setRequiredLevel 設定儲存前是否需要或建議欄位值。
setSubmitMode 設定欄位資料是否在儲存時提交。
設定值 設定欄位的資料值。

布林欄類型

除了所有欄位類型可用的方法外, 布林 欄位類型還提供以下方法:

Method Description
get初始值 回傳表單開啟時欄位的值。

查閱資料行類型

除了所有欄位類型可用的方法外, 查找 欄位類型還提供以下方法:

Method Description
getIsPartyList 回傳查詢是否允許多筆紀錄作為政黨名單查詢。

選擇和選擇欄類型

除了所有欄位類型可用的方法外, 選擇 欄位與 選擇 欄位類型還提供以下方法:

Method Description
get初始值 回傳表單開啟時欄位的值。
get選項 回傳與指定標籤或值相符的選項。
get選項 回傳該欄位的有效選項。
getSelected選項 回傳所選選項。
getText 回傳所選選項的文字。

數字欄類型(十進位、雙精度、整數、貨幣)

下列方法僅適用於 十進位、 雙精度和 整數 資料行:

Method Description
getMax 回傳該欄位的最大允許值。
getMin 回傳該欄位的最小允許值。
get精度 回傳小數點後允許的數字數。
設定精確度 設定小數點後允許的數字數。

字串資料行類型

除了先前說明適用於所有資料行類型的方法之外,下列方法僅適用於 字串 資料行:

Method Description
getMax長度 回傳該欄的最大字串長度。

了解 Xrm 物件模型
控制項 (用戶端 API 參考)