AppNotificationButton.AddArgument(String, String) Metodo

Definizione

Spazio dei nomi:

Microsoft.Windows.AppNotifications.Builder

Aggiunge un argomento composto da una coppia chiave/valore al payload XML per un pulsante di notifica dell'app.

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

Parametri

key

String

Platform::String

winrt::hstring

Stringa contenente la chiave dell'argomento.

value

String

Platform::String

winrt::hstring

Stringa contenente il valore dell'argomento.

Restituisce

AppNotificationButton

Restituisce l'istanza di AppNotificationButton in modo che sia possibile concatenare le chiamate di metodo aggiuntive.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di questo metodo per aggiungere argomenti a un pulsante di notifica dell'app.

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

AppNotificationManager.Default.Show(notification);

Payload XML risultante:

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

Commenti

Gli argomenti del pulsante di notifica dell'app aggiunti con questo metodo vengono passati all'applicazione attivata quando l'utente fa clic sul pulsante. È possibile aggiungere più argomenti a ogni pulsante. È possibile recuperare gli argomenti aggiunti con questo metodo o aggiungere più argomenti in una sola chiamata accedendo alla proprietà AppNotificationActivatedEventArgs.Arguments .

Per indicazioni sull'uso delle API AppNotificationBuilder per creare le notifiche dell'interfaccia utente per le app, vedere Contenuto di notifica dell'app.

Per informazioni di riferimento sullo schema XML per le notifiche dell'app, vedere Schema del contenuto di notifica dell'app.