Set 函式

適用於：畫布應用程式卡片 Dataverse 低程式碼外掛程式 Power Platform CLI

設定全域變數的值。

概觀

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

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

Power Apps 是建立在使用者與應用程式互動時自動重新計算的公式基礎上。任何因變數變更都會自動更新的公式。但是，若 Set 函式中使用的公式值變更，該變數將不會自動更新。這需要應用程式製作人員手動更新變數，這可能會容易發生並增加其他人的理解難度。使用變數之前，請先檢閱瞭解變數。

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

您可以在撰寫環境中 Power Apps Studio 中的 File 功能表下使用變數視圖查看變數值、定義和使用情況。

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

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

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

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

Set( 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，並將其值設定為記錄。該記錄有兩個欄位，名為 Name 和 Address。 Name 欄位值為 Milton，而 Address 欄位值為 1 Main St。	Person 具有 { Name: "Milton", Address: "1 Main St" } 記錄值。以名稱 Person 完整參考這筆記錄，或以 Person.Name 或 Person.Address 參考這筆記錄的個別欄位。
Set( Person, Patch( Person, {Address: "2 Main St" } ) )	搭配 Patch 函式更新 Person 全域變數，方法是將 Address 欄位值設定為 2 Main St。	Person 現在具有 { Name: "Milton", Address: "2 Main St" } 記錄值。