AppNotificationButton.AddArgument(String, String) Methode

Definition

Namespace:

Microsoft.Windows.AppNotifications.Builder

Fügt der XML-Nutzlast für eine App-Benachrichtigungsschaltfläche ein Argument hinzu, das aus einem Schlüssel-Wert-Paar besteht.

public:
 virtual AppNotificationButton ^ AddArgument(Platform::String ^ key, Platform::String ^ value) = AddArgument;

AppNotificationButton AddArgument(winrt::hstring const& key, winrt::hstring const& value);

public AppNotificationButton AddArgument(string key, string value);

function addArgument(key, value)

Public Function AddArgument (key As String, value As String) As AppNotificationButton

Parameter

key

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die den Schlüssel des Arguments enthält.

value

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die den Wert des Arguments enthält.

Gibt zurück

AppNotificationButton

Gibt die AppNotificationButton Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Beispiele

Das folgende Beispiel zeigt die Verwendung dieser Methode zum Hinzufügen von Argumenten zu einer App-Benachrichtigungsschaltfläche.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddButton(new AppNotificationButton("Reply")
        .AddArgument("action", "reply"))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <actions>
        <action content='Reply' arguments='action=reply'/>
    </actions>
</toast>

Hinweise

Mit dieser Methode hinzugefügte Argumente der App-Benachrichtigungsschaltfläche werden an die aktivierte Anwendung übergeben, wenn der Benutzer auf die Schaltfläche klickt. Sie können jeder Schaltfläche mehrere Argumente hinzufügen. Sie können die mit dieser Methode hinzugefügten Argumente abrufen oder mehrere Argumente in einem Aufruf hinzufügen, indem Sie auf die AppNotificationActivatedEventArgs.Arguments-Eigenschaft zugreifen.

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.