AppNotificationBuilder.SetScenario(AppNotificationScenario) 方法

定义

设置应用通知的方案,这会导致系统调整某些通知行为,以便为指定的方案提供一致的体验。

public:
 virtual AppNotificationBuilder ^ SetScenario(AppNotificationScenario value) = SetScenario;
AppNotificationBuilder SetScenario(AppNotificationScenario const& value);
public AppNotificationBuilder SetScenario(AppNotificationScenario value);
function setScenario(value)
Public Function SetScenario (value As AppNotificationScenario) As AppNotificationBuilder

参数

value
AppNotificationScenario

枚举中的一个值, AppNotificationScenario 该值指定应用通知的方案。

返回

返回 AppNotificationBuilder 实例,以便可以链接其他方法调用。

示例

以下示例演示如何在应用通知的 XML 有效负载中设置通知方案。

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Reminder)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

生成的 XML 有效负载:

<toast scenario='reminder'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
</toast>

注解

紧急方案值仅在 Windows 10 版本 19041 及更高版本上受支持。 调用 IsUrgentScenarioSupported 以确定在运行时当前设备上是否支持紧急方案。

有关使用 AppNotificationBuilder API 创建应用通知 UI 的指导,请参阅 应用通知内容

有关应用通知的 XML 架构的参考信息,请参阅 应用通知内容架构

适用于