AppNotificationBuilder.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 una notificación de aplicación.

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

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

AppNotificationBuilder

Devuelve la instancia de AppNotificationBuilder 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 una notificación de aplicación.

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

AppNotificationManager.Default.Show(notification);

La carga XML resultante:

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

Comentarios

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

Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones 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.