WalletItemStore.AddAsync(String, WalletItem) メソッド

定義

名前空間:

Windows.ApplicationModel.Wallet

注意事項

ApplicationModel.Wallet 名前空間はサポートされなくなり、間もなく非推奨になります。 開発者は、この名前空間を使用しないようにすることをお勧めします。

ウォレットに新しいウォレットアイテムを追加します。

public:
 virtual IAsyncAction ^ AddAsync(Platform::String ^ id, WalletItem ^ item) = AddAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Deprecated("IWalletItemStore is deprecated and might not work on all platforms. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 917504, "Windows.Foundation.UniversalApiContract")]
IAsyncAction AddAsync(winrt::hstring const& id, WalletItem const& item);

[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Deprecated("IWalletItemStore is deprecated and might not work on all platforms. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 917504, "Windows.Foundation.UniversalApiContract")]
public IAsyncAction AddAsync(string id, WalletItem item);

function addAsync(id, item)

Public Function AddAsync (id As String, item As WalletItem) As IAsyncAction

パラメーター

id

String

Platform::String

winrt::hstring

ウォレットアイテムの識別子。 この値は一意である必要があります。 これにより、初期 WalletItem.Id 値が設定されます (識別子は WalletItemStore ストア用であり、 WalletItem オブジェクトの初期化の一部ではありません)。

item

WalletItem

ウォレットに追加するウォレットアイテム。

戻り値

IAsyncAction

非同期アクション。 非同期プログラミングを使用する場合、戻り値の型は void です。

属性

RemoteAsyncAttribute DeprecatedAttribute

注釈

このメソッドに渡される ID 値が一意でない場合、またはアイテムが既にウォレットに追加されている場合は、例外がスローされます。 エラー/例外を処理する方法は、プログラミング言語によって異なります。特に非同期メソッドを呼び出す場合は特に異なります。 「非同期プログラミング」を参照してください。

このメソッドを呼び出すと、アプリではなくデバイスが所有するウォレットアイテムストアにアイテムが追加されます。 開発中は、ストアはアプリ セッション間で保持されるため、別のデバッグ セッションを実行するときに同じ項目を再度追加しようとすると、項目が既に存在するため、例外がスローされる可能性があります。 項目を追加する前に ClearAsync への呼び出しを追加することを検討してください。少なくともコードの開発とテスト中は、コードを複数回実行します。

こちらもご覧ください

• 非同期プログラミング
• クイック スタート: API の使用