適用於：
畫布應用程式 桌面流程 Power Platform CLI Dataverse 函數
設定全域變數的值。
概觀
使用函數 Set 可以設定全域變數的值，該變數暫時保存一條訊息，例如使用者選擇按鈕的次數或資料操作的結果。
全域變數在整個應用程式的所有畫面上皆可使用。 這些是最簡單的變數類型，且可滿足多數情況下的需求。 另外還有上下文變數，範圍為單一畫面和允許資料列層級修改至資料表的集合物件。 如需其他選項的詳細資訊，請參閱 瞭解變數。
Power Apps 是建立在使用者與應用程式互動時自動重新計算的公式基礎上。 任何因變數變更都會自動更新的公式。 不過，如果函數中使用的 Set 公式值變更，變數將不會自動更新。 這需要應用程式製作人員手動更新變數，這可能會容易發生並增加其他人的理解難度。 使用變數之前，請先檢閱 瞭解變數。
描述
全域變數是使用函數 Set 隱含地建立的。 不需要明確宣告。 如果您移除 Set 全域變數的所有函數，則該全域變數將不復存在。 若要清除變數，將其值設為 Blank 函式 的結果。
您可以在撰寫環境中 Power Apps Studio 中的 File 功能表下使用變數視圖查看變數值、定義和使用情況。
如本主題稍後的範例所示，全域變數可以保留幾種資訊，包含下列幾種︰
- 單一值
- 記錄
- 資料表
- 物件參考
- 來自公式的任何結果
全域變數會保留其值直到應用程式關閉。 一旦關閉後，全域變數的值將會遺失，必須再次載入應用程式才會重新建立。
全域變數不能使用與現有集合物件或控制項相同的名稱。 可以使用與內容變數相同的名稱。 若要釐清兩者，請使用 去除混淆運算子。
Set 沒有傳回值，而且您只能在 行為公式內使用它。
語法
Set（ 變數名稱， 值 ）
- VariableName - 必需。 要建立或更新的全域變數名稱。
- value - 必需。 要指派給上下文變數的值。
範例
| 公式 | 描述 | 結果 |
|---|---|---|
| Set（ 櫃台， 1 ） | 建立或修改全域變數 Counter，並將其值設定為 1。 | Counter 的值為 1。 您可以在任何畫面的公式中使用名稱 Counter 參考該變數。 |
| Set（ 計數器， 2 ） | 將上個範例的 Counter 全域變數值設定為 2。 | Counter 的值為 2。 |
| Set（ 計數器， 計數器 + 1 ） | 將上個範例的 Counter 全域變數值增加為 3。 | Counter 的值為 3。 |
| Set（ 名字，“莉莉” ） | 建立或修改全域變數 Name，並將其值設定為 Lily。 | Name 的值為 Lily。 |
| Set（ 人， { 姓名： “Milton”， 地址： “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， {地址： “2 Main St” } ） ） | 搭配 Patch 函式更新 Person 全域變數，方法是將 Address 欄位值設定為 2 Main St。 | Person 現在具有記錄 { Name：“Milton”，Address：“2 Main St” } 的值。 |