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 的指引，請參閱 應用程式通知內容。

如需應用程式通知 XML 架構的參考資訊，請參閱 應用程式通知內容架構。