Notify 函数

适用于:画布应用模型驱动应用 Power Platform CLI

向用户显示横幅消息。

Description

Notify 函数在屏幕顶部向用户显示横幅消息。 通知将一直保留,直到用户将其取消或超时(默认为 10 秒)结束。

根据消息的类型,使用适当的颜色和图标。 该类型由该函数的第二个参数指定:

备注

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 毫秒)。 通知无限期显示,其超时为 0。

示例

分步操作

  1. 向屏幕添加 Button 控件。

  2. 将此 ButtonOnSelect 属性设置为以下公式:

    Notify( "Hello, World" )
    
  3. 单击或按下该按钮。

    每次单击该按钮时,会将消息 Hello, World 作为信息显示给用户。 如果用户没有关闭或再次按下按钮,则会在 10 秒钟内自动关闭(默认超时)。

    在创作环境中,显示 Button.OnSelect、调用 Notify 并将生成的“Hello, World”消息作为蓝色横幅消息显示给用户。

  4. 更改消息的类型以指示错误。 将第二个参数添加到公式中:

    Notify( "Hello, World", NotificationType.Error )
    
  5. 单击或按下该按钮。

    现在,每次单击该按钮时,会将消息 Hello, World 作为错误显示给用户。 如果用户没有关闭或再次按下按钮,则会在 10 秒钟内自动关闭(默认超时)。

    在创作环境中,显示 Button.OnSelect、调用 Notify 并将生成的“Hello, World”消息作为红色横幅消息显示给用户。

  6. 更改消息的类型以指示警告。 更改公式中的第二个参数:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. 单击或按下该按钮。

    现在,每次单击该按钮时,会将消息 Hello, World 作为警告显示给用户。 如果用户没有关闭或再次按下按钮,则会在 4 秒(4000 毫秒)内自动关闭。

    在创作环境中,显示 Button.OnSelect、调用 Notify 并将生成的“Hello, World”消息作为橙色横幅消息显示给用户。

  8. 更改消息的类型以指示成功。 更改公式中的第二个参数:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. 单击或按下该按钮。

    现在,每次单击该按钮时,会将消息 Hello, World 显示给用户表示成功。 使用 0 超时,通知只会由用户或通过再次按下按钮消除。

    在创作环境中,显示 Button.OnSelect、调用 Notify 并将生成的“Hello, World”消息作为绿色横幅消息显示给用户。