建立及清除集合,並將記錄新增至任何資料來源

說明

Collect

Collect 函式會將記錄新增至資料來源。 要新增的項目可以是︰

  • 單一值︰值會放在新記錄的欄位。 所有其他屬性會保留空白

  • 記錄︰每個具名的屬性會放在新記錄的對應屬性中。 所有其他屬性會保留空白。

  • 資料表︰資料表的每一筆記錄會新增為資料來源的個別記錄 (如上所述)。 資料表不會做為巢狀資料表新增至記錄。 若要達成此目的,先將資料表包裝在記錄中。

當與集合搭配使用時,將視需要建立其他資料行。 資料來源會固定其他資料來源的資料行,且無法新增新的資料行。

如果資料來源尚未存在,則會建立集合。

集合有時候會用來保存全域變數,或製作資料來源的暫存副本。 PowerApps 取決於使用者與應用程式互動時所自動重新計算的公式。 集合不喜歡這項權益,且其使用會讓您的應用程式更難以建立及了解。 以這種方式使用集合之前,請檢閱使用變數

您也可以使用 Patch 函式在資料來源中建立記錄。

Collect 會傳回已修改的資料來源做為資料表。 Collect 僅能在行為公式中使用。

清除

Clear 函式會刪除集合的所有記錄。 會保留集合的資料行。

請注意,Clear 只會在集合而不會在其他資料來源上運作。 您可以針對此目的使用 RemoveIf( DataSource, true )。 請謹慎,因為這將會從資料來源的儲存體中移除所有記錄,且可能會影響其他使用者。

您可以使用 Remove 函式以選擇性地移除記錄。

Clear 沒有傳回值。 它僅能在行為公式中使用。

ClearCollect

ClearCollect 函式會從集合中刪除所有記錄,並將一組不同的記錄新增至相同的集合。 使用單一函式,ClearCollect 提供 ClearCollect的組合。

ClearCollect 會傳回已修改的集合做為資料表。 ClearCollect 僅能在行為公式中使用。

語法

Collect( DataSource, Item, ... )

  • DataSource – 必要項目。 您想要新增資料的資料來源。 如果它尚未存在,則會建立新的集合。
  • Item(s) - 必要項目。 要新增至資料來源的一或多個記錄或資料表。

Clear( Collection )

  • Collection – 必要項目。 您想要清除的集合。

ClearCollect( Collection, Item, ... )

  • Collection – 必要項目。 您想要清除然後新增資料的集合。
  • Item(s) - 必要項目。 要新增至資料來源的一或多個記錄或資料表。

範例

將記錄清除並新增至資料來源

在這些範例中,您將會清除並新增至名為 IceCream 的集合。 資料來源會以這些內容開始︰

公式 說明 結果
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) IceCream 集合清除所有資料,然後新增包含草莓冰淇淋數量的記錄。

IceCream 資料來源也已修改。
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) 將兩個記錄新增至包含開心果及橘色冰淇淋數量的 IceCream 集合。

IceCream 資料來源也已修改。
Clear( IceCream ) IceCream 集合移除所有記錄。

IceCream 資料來源也已修改。

逐步解說

  1. 新增一個按鈕,並將其 OnSelect 屬性設為此函式:
    Collect(Products, "Europa", "Ganymede", "Callisto")

    此函式會建立名為產品的集合,其包含三個產品名稱的資料列。

  2. 按 F5、按一下按鈕,然後按 Esc 鍵以返回 [設計] 工作區。

  3. (選擇性) 若要顯示您所建立之集合的預覽,請按一下 [內容] 索引標籤上的 [集合]。