設定全域變數的值。

概觀

使用 Set 函式來設定全域變數值,此變數可暫時存放一項資訊,例如使用者選取按鈕的次數或資料作業的結果。

全域變數在整個應用程式的所有畫面上皆可使用。 這些是最簡單的變數類型,且可滿足多數情況下的需求。 另外還有內容變數,範圍為單一畫面和允許資料列層級修改至資料表的集合。 有關其他選項的詳細資訊,請參閱使用變數

PowerApps 取決於使用者與應用程式互動時所自動重新計算的公式。 全域變數並不會提供這項好處,因此會讓您的應用程式變得更難建立和了解。 使用變數之前,請先檢閱使用變數

說明

全域變數使用 Set 函式隱含建立。 不需要明確宣告。 如果移除全域變數所有的 Set 函式,則該全域變數就不會存在。 若要清除變數,將其值設為 Blank 函式的結果。

您可以在撰寫環境中 [檔案] 功能表底下的 [變數] 檢視查看變數的值、定義和使用情況。

如本主題稍後的範例所示,全域變數可以保留幾種資訊,包含下列幾種︰

  • 單一值
  • 記錄
  • 資料表
  • 物件參考
  • 來自公式的任何結果

全域變數會將值保留起來,直到應用程式關閉。 一旦關閉後,全域變數的值將會遺失,必須在再次載入應用程式時重新建立。

全域變數不能使用與現有集合或控制項相同的名稱。 可以使用與內容變數相同的名稱。 若要釐清兩者,請使用去除混淆運算子

Set 沒有傳回值,因此您只能在行為公式內使用它。

語法

Set( VariableName, Value )

  • VariableName - 必要項目。 要建立或更新之全域變數的名稱。
  • Value - 必要項目。 要指派給內容變數的值。

範例

公式 說明 結果
Set( Counter, 1 ) 建立或修改全域變數 Counter,並將其值設定為 1 Counter 的值為 1。 您可以在任何畫面的公式中使用名稱 Counter 來參考該變數。
Set( Counter, 2 ) 將上一個範例之 Counter 全域變數的值設定為 2 Counter 的值為 2
Set( Counter, Counter + 1 ) 將上一個範例之 Counter 全域變數的值增加為 3 Counter 的值為 3
Set( Name, "Lily" ) 建立或修改全域變數 Name,並將其值設定為 Lily Name 的值為 Lily
Set( Person, { Name: "Milton", Address: "1 Main St" } ) 建立或修改全域變數 Person,並將其值設定為記錄。 該記錄有兩個資料行,名為 NameAddressName 資料行的值為 Milton,而 Address 資料行的值為 1 Main St Person 有記錄 { Name: "Milton", Address: "1 Main St" } 的值。

以名稱 Person 完整參考這筆記錄,或以 Person.NamePerson.Address 參考這筆記錄的個別資料行。
Set( Person, Patch( Person, {Address: "2 Main St" } ) ) 搭配 Patch 函式運作以更新 Person 全域變數,方法是將 Address 資料行的值設定為 2 Main St Person 現在有記錄 { Name: "Milton", Address: "2 Main St" } 的值。