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 設定的值，並且無論體驗如何，這些值都會受到尊重。

語法

Notify (Message [，NotificationType [ ，Timeout ]])

• Message - 必要。 要向使用者顯示的訊息。
• NotificationType - 非必要。 上表中要顯示的訊息類型。 預設為 NotificationType.Information。
• Timeout – 非必要。 自動關閉通知之前的等待毫秒數。 預設值為 10 秒 (或 10,000 毫秒)。 通知會無限期顯示 Timeout 為 0。

範例

逐步

1. 新增 Button 控制項到您的畫面。

2. 將 Button 的 OnSelect 屬性設為下列公式：

   Notify( "Hello, World" )
   

3. 點擊或點選按鈕。

   每次點擊按鈕，都會向使用者顯示 Hello, World 資訊訊息。 如果使用者未解除或再次按下按鈕，它會在 10 秒 (預設超時) 內自動消失。

   

4. 變更訊息類型以指出這是錯誤。 將第二個引數新增至我們的公式：

   Notify( "Hello, World", NotificationType.Error )
   

5. 點擊或點選按鈕。

   現在，每次按一下按鈕，都會向使用者顯示 Hello, World 錯誤訊息。 如果使用者未解除或再次按下按鈕，它會在 10 秒 (預設超時) 內自動消失。

   

6. 變更訊息類型以指出這是警告。 變更公式中的第二個引數：

   Notify( "Hello, World", NotificationType.Warning, 4000 )
   

7. 點擊或點選按鈕。

   現在，每次點擊按鈕，都會向使用者顯示 Hello, World 警告訊息。 如果使用者未解除或再次按下按鈕，它會在 4 秒 (4,000 毫秒) 內自動消失。

   

8. 變更訊息類型以指出成功。 變更公式中的第二個引數：

   Notify( "Hello, World", NotificationType.Success, 0 )
   

9. 點擊或點選按鈕。

   現在，每次按一下按鈕，都會向使用者顯示 Hello, World 成功訊息。 使用 0 超時時，通知將只會由使用者解除，或再次按下按鈕。