AppNotificationBuilder.AddArgument(String, String) 方法

定義

命名空間:

Microsoft.Windows.AppNotifications.Builder

將由索引鍵/值組組成的自變數新增至應用程式通知的 XML 承載。

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

參數

key

String

Platform::String

winrt::hstring

包含自變數索引鍵的字串。

value

String

Platform::String

winrt::hstring

包含自變數值的字串。

傳回

AppNotificationBuilder

傳回 AppNotificationBuilder 實例，以便鏈結其他方法呼叫。

範例

下列範例顯示這個方法的使用方式，將自變數新增至應用程式通知。

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

AppNotificationManager.Default.Show(notification);

產生的 XML 承載：

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

備註

當使用者按一下通知時，使用此方法新增的應用程式通知自變數會傳遞至啟動的應用程式。 您可以將多個自變數新增至每個通知。 藉由存取 AppNotificationActivatedEventArgs.Arguments 屬性，擷取以這個方法新增的自變數。

如需使用 AppNotificationBuilder API 來建立應用程式通知 UI 的指引，請參閱 應用程式通知內容。

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