Notify 函式
適用於：
畫布應用 模型驅動應用 Power Platform CLI
向使用者顯示橫幅訊息。
Description
Notify 函式會在畫面頂端向使用者顯示橫幅訊息。 通知將保留，直到使用者取消通知或逾時 (預設為 10 秒)。
系統會根據訊息類型使用適當的色彩和圖示。 此函式的第二個引數會指定類型：
Note
Notify 函式的字元限制為 500 個字元。
| NotificationType 引數 | 描述 |
|---|---|
| NotificationType.Error | 顯示錯誤訊息。 |
| NotificationType.Information （預設） | 顯示資訊訊息。 |
| NotificationType.Success | 顯示成功訊息。 |
| NotificationType.Warning 通知類型 | 顯示警告訊息。 |
在撰寫您的應用程式以及當終端使用者使用您的應用程式時，都會顯示訊息。
Notify 只能在行為 公式中使用。
Notify 可以與 IfError 函數配對， 以檢測和報告帶有自定義錯誤消息的錯誤。
Power Apps 也可以使用與 Notify 完全不同的機制傳送推播通知。 如需詳細資訊，請參閱 在 Power Apps 傳送通知。
Notify 始終返回 true。
注意：此函式之前命名為 ShowError，它只能顯示錯誤訊息。
注意
通知可用於獨立畫布應用程式、自訂頁面和 Power Fx 命令體驗。 NotificationType 和 Timeout 的預設值會根據其使用體驗而有所不同。 您可以透過在 Power Fx 運算式中明確設定來指定要為 NotificationType 和 Timeout 設定的值，並且無論體驗如何，這些值都會受到尊重。
語法
通知 ( 消息 [， 通知類型 [， 超時 ] ] ])
- Message –必需。 要向使用者顯示的訊息。
- NotificationType –可選。 上表中要顯示的訊息類型。 預設為 NotificationType.Information。
- Timeout —可選。 自動關閉通知之前的等待毫秒數。 預設值為 10 秒 (或 10,000 毫秒)。 通知會無限期顯示 Timeout 為 0。
範例
逐步
新增 Button 控制項到您的畫面。
將 Button 的 OnSelect 屬性設為下列公式：
Notify( "Hello, World" )點擊或點選按鈕。
每次點擊按鈕，都會向使用者顯示 Hello, World 資訊訊息。 如果使用者未解除或再次按下按鈕，它會在 10 秒 (預設超時) 內自動消失。
變更訊息類型以指出這是錯誤。 將第二個引數新增至我們的公式：
Notify( "Hello, World", NotificationType.Error )點擊或點選按鈕。
現在，每次按一下按鈕，都會向使用者顯示 Hello, World 錯誤訊息。 如果使用者未解除或再次按下按鈕，它會在 10 秒 (預設超時) 內自動消失。
變更訊息類型以指出這是警告。 變更公式中的第二個引數：
Notify( "Hello, World", NotificationType.Warning, 4000 )點擊或點選按鈕。
現在，每次點擊按鈕，都會向使用者顯示 Hello, World 警告訊息。 如果使用者未解除或再次按下按鈕，它會在 4 秒 (4,000 毫秒) 內自動消失。
變更訊息類型以指出成功。 變更公式中的第二個引數：
Notify( "Hello, World", NotificationType.Success, 0 )點擊或點選按鈕。
現在，每次按一下按鈕，都會向使用者顯示 Hello, World 成功訊息。 使用 0 超時時，通知將只會由使用者解除，或再次按下按鈕。
