AppNotificationButton.AddArgument(String, String) 方法

定义

命名空间:

Microsoft.Windows.AppNotifications.Builder

将由键/值对组成的参数添加到应用通知按钮的 XML 有效负载。

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

参数

key

String

Platform::String

winrt::hstring

包含参数键的字符串。

value

String

Platform::String

winrt::hstring

包含参数值的字符串。

返回

AppNotificationButton

返回 AppNotificationButton 实例，以便可以链接其他方法调用。

示例

以下示例演示如何使用此方法将参数添加到应用通知按钮。

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

AppNotificationManager.Default.Show(notification);

生成的 XML 有效负载：

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

注解

当用户单击该按钮时，使用此方法添加的应用通知按钮参数将传递给激活的应用程序。 可以将多个参数添加到每个按钮。 可以通过访问 AppNotificationActivatedEventArgs.Arguments 属性来检索使用此方法添加的参数，或在一次调用中添加多个参数。

有关使用 AppNotificationBuilder API 创建 UI forapp 通知的指导，请参阅 应用通知内容。

有关应用通知的 XML 架构的参考信息，请参阅 应用通知内容架构。