AppNotificationButton.AddArgument(String, String) Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Agrega un argumento compuesto por un par clave-valor a la carga XML de un botón de notificación de aplicación.

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

Parámetros

key

String

Platform::String

winrt::hstring

Cadena que contiene la clave del argumento.

value

String

Platform::String

winrt::hstring

Cadena que contiene el valor del argumento.

Devoluciones

AppNotificationButton

Devuelve la instancia de AppNotificationButton para que se puedan encadenar llamadas de método adicionales.

Ejemplos

En el ejemplo siguiente se muestra el uso de este método para agregar argumentos a un botón de notificación de aplicación.

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

AppNotificationManager.Default.Show(notification);

La carga XML resultante:

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

Comentarios

Los argumentos del botón de notificación de aplicación agregados con este método se pasan a la aplicación activada cuando el usuario hace clic en el botón. Puede agregar varios argumentos a cada botón. Puede recuperar los argumentos agregados con este método, o agregar varios argumentos en una llamada, accediendo a la propiedad AppNotificationActivatedEventArgs.Arguments .

Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear las notificaciones de la interfaz de usuario de la aplicación, consulte El contenido de la notificación de la aplicación.

Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicación, consulte Esquema de contenido de notificación de aplicaciones.