Compartilhar via


WalletItemStore.AddAsync(String, WalletItem) Método

Definição

Cuidado

O namespace ApplicationModel.Wallet não tem mais suporte e, em breve, será preterido. Os desenvolvedores são incentivados a evitar o uso desse namespace.

Adiciona um novo item de carteira à carteira.

public:
 virtual IAsyncAction ^ AddAsync(Platform::String ^ id, WalletItem ^ item) = AddAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
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")]
IAsyncAction AddAsync(winrt::hstring const& id, WalletItem const& item);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction AddAsync(string id, WalletItem 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

Parâmetros

id
String

Platform::String

winrt::hstring

O identificador do item de carteira. Esse valor deve ser exclusivo. Isso define o valor inicial WalletItem.Id (o identificador é para o repositório WalletItemStore e não faz parte da inicialização de um objeto WalletItem .

item
WalletItem

O item de carteira a ser adicionado à carteira.

Retornos

Uma ação assíncrona. Se você usar a programação assíncrona, o tipo de retorno será nulo.

Atributos

Comentários

Se o valor da ID passado para esse método não for exclusivo ou se o item já tiver sido adicionado à carteira, uma exceção será gerada. Como lidar com erros/exceções varia de acordo com a linguagem de programação, especialmente ao chamar métodos assíncronos. Consulte Programação assíncrona.

Lembre-se de que quando você chama esse método, o item é adicionado ao repositório de itens da carteira, que pertence ao dispositivo e não ao aplicativo. Enquanto você ainda está desenvolvendo, o repositório persiste entre sessões de aplicativo e, portanto, tentar adicionar o mesmo item novamente ao executar outra sessão de depuração pode gerar uma exceção porque o item já está lá. Considere adicionar uma chamada ao ClearAsync antes de tentar adicionar quaisquer itens e executar seu código mais de uma vez, pelo menos enquanto ainda estiver desenvolvendo e testando seu código.

Aplica-se a

Confira também