AppNotificationBuilder.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 una notifica dell'app.

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

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

public AppNotificationBuilder AddArgument(string key, string value);

function addArgument(key, value)

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

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

AppNotificationBuilder

Restituisce l'istanza di AppNotificationBuilder in modo che sia possibile concatenare altre chiamate al metodo.

Esempio

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

var notification = new AppNotificationBuilder()
    .AddText("Send a message.")
    .AddTextBox("textBox")
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Payload XML risultante:

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

Commenti

Gli argomenti di notifica dell'app aggiunti con questo metodo vengono passati all'applicazione attivata quando l'utente fa clic sulla notifica. È possibile aggiungere più argomenti a ogni notifica. Recuperare gli argomenti aggiunti con questo metodo accedendo alla proprietà AppNotificationActivatedEventArgs.Arguments .

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

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