AppNotificationBuilder.AddArgument(String, String) Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Adiciona um argumento composto por um par chave/valor ao conteúdo XML de uma notificação de aplicativo.

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

Uma cadeia de caracteres que contém a chave do argumento.

value

String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém o valor do argumento.

Retornos

AppNotificationBuilder

Retorna a instância AppNotificationBuilder para que chamadas de método adicionais possam ser encadeadas.

Exemplos

O exemplo a seguir mostra o uso desse método para adicionar argumentos a uma notificação do aplicativo.

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

AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

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

Comentários

Os argumentos de notificação do aplicativo adicionados com esse método são passados para o aplicativo ativado quando o usuário clica na notificação. Você pode adicionar vários argumentos a cada notificação. Recupere os argumentos adicionados com esse método acessando a propriedade AppNotificationActivatedEventArgs.Arguments.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte esquema de conteúdo de notificação do aplicativo.