AppNotificationBuilder.SetScenario(AppNotificationScenario) Methode

Referenz

Definition

Namespace:: Microsoft.Windows.AppNotifications.Builder

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Legt das Szenario für die App-Benachrichtigung fest, das dazu führt, dass das System einige der Benachrichtigungsverhaltensweisen anpasst, um eine konsistente Benutzeroberfläche für das angegebene Szenario zu bieten.

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

Parameter

value: AppNotificationScenario

Ein Wert aus der AppNotificationScenario -Enumeration, der das Szenario für die App-Benachrichtigung angibt.

Gibt zurück

AppNotificationBuilder

Gibt den AppNotificationBuilder-instance zurück, damit zusätzliche Methodenaufrufe verkettet werden können.

Beispiele

Das folgende Beispiel veranschaulicht das Festlegen des Benachrichtigungsszenarios in der XML-Nutzlast für eine App-Benachrichtigung.

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

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

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

Hinweise

Der Wert des dringenden Szenarios wird nur für Windows 10 Build 19041 und höher unterstützt. Rufen Sie IsUrgentScenarioSupported auf, um zur Laufzeit zu ermitteln, ob das dringende Szenario auf dem aktuellen Gerät unterstützt wird.

Eine Anleitung zur Verwendung der AppNotificationBuilder-APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalte.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter Inhaltsschema für App-Benachrichtigungen.

Gilt für:

Freigeben über