AppNotificationBuilder.SetGroup(String) 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 den Gruppenbezeichner für eine App-Benachrichtigung fest.

public:
 virtual AppNotificationBuilder ^ SetGroup(Platform::String ^ group) = SetGroup;

AppNotificationBuilder SetGroup(winrt::hstring const& group);

public AppNotificationBuilder SetGroup(string group);

function setGroup(group)

Public Function SetGroup (group As String) As AppNotificationBuilder

Parameter

group: String
Platform::String

winrt::hstring

Eine Zeichenfolge, die die Gruppe angibt, zu der die App-Benachrichtigung gehört.

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 der Gruppe für eine App-Benachrichtigung.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetGroup("Notification group")
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

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

Ein Beispiel für das Entfernen aller Benachrichtigungen aus dem Benachrichtigungscenter nach Gruppe.

await AppNotificationManager.Default.RemoveByGroupAsync("Notification group");

Hinweise

Sie können den Gruppenbezeichner verwenden, um alle App-Benachrichtigungen in einer Gruppe aus dem Benachrichtigungscenter zu entfernen, indem Sie AppNotificationManager.RemoveByGroupAsyncaufrufen.

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:

Freigeben über