分享方式：

集合 (用戶端參考)

  • 文章

 

發佈日期： 2017年1月

適用對象： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

集合是讓您存取資料 (代表陣列) 的結構，但是沒有修改陣列資料的能力。

下列清單顯示 Xrm.Page 物件模型的集合：

  • Xrm.Page.data.entity.屬性：頁面上的所有屬性。

  • Xrm.Page.ui. 0375b206-d2bf-4034-a41d-fb476ecb4438#BKMK_controls：頁面上的所有控制項。

  • Xrm.Page.ui. 0375b206-d2bf-4034-a41d-fb476ecb4438#bkmk_quickForms：頁面上所有使用新的表單轉譯引擎的快速檢視控制項。

  • Xrm.Page.ui. 0375b206-d2bf-4034-a41d-fb476ecb4438#BKMK_tabs：頁面上的所有索引標籤。

  • Xrm.Page.ui Tab. 205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_tabSectionsCollection：索引標籤上的所有區段。

  • Xrm.Page.ui Section. a90df20b-42a6-444e-9912-e0ffab11daec#BKMK_sectionControls：區段中的所有任何控制項。

  • Xrm.Page.ui. 0375b206-d2bf-4034-a41d-fb476ecb4438#BKMK_navigation：在表單導覽區域中的任何項目。

  • Xrm.Page.ui. 0375b206-d2bf-4034-a41d-fb476ecb4438#BKMK_FormSelectorItems：可讓使用者使用的所有表單。

  • Xrm.Page Attribute.控制項：屬性的任何控制項。

  • Xrm.Page.data.process.getActivePath：根據分支規則，目前使用中路徑的階段。

  • Xrm.Page.data.process.getActiveProcess 所傳回程序的程序 getStages 方法。

  • Xrm.Page.data.process.getActiveStage、Xrm.Page.data.process.getActivePath 和 Xrm.Page.data.process.getActiveProcess 所傳回階段的階段 getSteps 方法。

備註

在 Xrm.Page.data.process 命名空間中傳回的物件不包含名稱，因此，使用 get 方法的字串參數沒有傳回物件。

在 Microsoft Dynamics CRM Online 2015 更新 1 中，27fea949-c332-4263-bb46-d990a18008b8#BKMK_GridGetRows和 27fea949-c332-4263-bb46-d990a18008b8#BKMK_GridGetSelectedRows會傳回 27fea949-c332-4263-bb46-d990a18008b8#BKMK_GridRow 集合。其他資訊：Grid (唯讀) 物件和方法 (用戶端參考)

集合方法

  • forEach
    將委派函數中的動作套用至集合中的每個物件。

  • get
    根據傳遞的引數，從集合取得一個或多個物件。

  • getLength
    取得集合中的項目數目。

forEach

套用委派函數中包含的動作。

collection.forEach(delegate function(attribute, index))
  • 引數
    委派函數，具有屬性與索引的參數。

get

根據傳遞的引數，從集合取得一個或多個物件。

collection.get([String][Number][delegate function(attribute, index)])

備註

使用 Xrm.Page.getAttribute 捷徑方法，Xrm.Page.data.entity.attributes 集合的 get 方法可供使用。

使用 Xrm.Page.getControl 捷徑方法，Xrm.Page.ui.controls 集合的 get 方法可供使用。

  • 引數

    • 無​​

      • 傳回值：集合中的所有物件。
        類型： 陣列

    • 字串

      • 傳回值：名稱符合引數所在的物件。
        類型： 物件

        備註： 在 Xrm.Page.data.process 命名空間中傳回的物件不包含名稱，因此，使用此方法的字串參數沒有傳回物件。

    • 編號

      • 傳回值：索引符合數字所在的物件
        類型： 物件

    • 委託函數（屬性，索引）

      • 傳回值：造成委派函數傳回 true 的任何物件。
        類型： 陣列

getLength

取得集合中的項目數目。

collection.getLength()
  • 傳回值
    類型： 數字

另請參閱

表單指令碼快速參考
用戶端程式設計參考
Xrm.Page.data.entity (用戶端參考)
Xrm.Page.ui (用戶端參考)
Xrm.Page.ui 索引標籤 (用戶端參考)
Xrm.Page.ui 區段 (用戶端參考)
Xrm.Page.data.entity 屬性 (用戶端參考)
撰寫 Microsoft Dynamics 365 表單的程式碼
使用 Xrm.Page 物件模型

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權