AppNotificationBuilder.SetScenario(AppNotificationScenario) 方法

定义

命名空间:

Microsoft.Windows.AppNotifications.Builder

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

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

返回 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 架构的参考信息，请参阅 应用通知内容架构。