AppNotificationButton.AddArgument(String, 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

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 den AppNotificationButton-instance zurück, damit 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 App-Benachrichtigungsschaltflächenargumente 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 Inhaltsschema für App-Benachrichtigungen.

Gilt für:

Freigeben über