AppNotificationBuilder.SetScenario(AppNotificationScenario) Methode

Definition

Namespace:
Microsoft.Windows.AppNotifications.Builder
Bearbeiten

Legt das Szenario für die App-Benachrichtigung fest, wodurch das System einige der Benachrichtigungsverhalten so anpasst, dass für das angegebene Szenario eine konsistente Benutzeroberfläche angezeigt wird.

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-Aufzählung , der das Szenario für die App-Benachrichtigung angibt.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass 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.

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

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

Gilt für: