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>

注釈

このメソッドで追加されたアプリ通知ボタンの引数は、ユーザーがボタンをクリックするとアクティブ化されたアプリケーションに渡されます。 各ボタンに複数の引数を追加できます。 このメソッドで追加された引数を取得したり、1 回の呼び出しで複数の引数を追加したりするには、AppNotificationActivatedEventArgs.Arguments プロパティにアクセスします。

AppNotificationBuilder API を使用して UI forapp 通知を作成する方法については、「アプリ通知コンテンツ」を参照してください。

アプリ通知の XML スキーマのリファレンス情報については、「アプリ通知コンテンツ スキーマ」を参照してください。