Idioma

NdefFormatable.FormatReadOnlyAsync(NdefMessage) Método

Definição

Formata a marca para NDEF, opcionalmente grava uma mensagem e torna a marca somente leitura em um thread do pool de threads.

public System.Threading.Tasks.Task FormatReadOnlyAsync(Android.Nfc.NdefMessage? firstMessage);
member this.FormatReadOnlyAsync : Android.Nfc.NdefMessage -> System.Threading.Tasks.Task

Parâmetros

firstMessage
NdefMessage

A mensagem NDEF a ser gravada após a formatação ou null ignorar a gravação da mensagem antes de fazer a marca somente leitura.

Retornos

Uma tarefa que representa a chamada para FormatReadOnly(NdefMessage).

Comentários

Esse wrapper gerenciado usa Task.Run para chamar FormatReadOnly(NdefMessage). Conecte-se primeiro e aguarde a tarefa antes de iniciar outra operação. Tornar a marca somente leitura é irreversível. Formatação, gravação e bloqueio são etapas separadas; uma falha posterior não desfaz uma etapa anterior.

Se o serviço NFC morrer durante a chamada, a implementação fixada do Android registrará o RemoteException log e retornará sem jogá-lo. Somente a conclusão da tarefa não confirma que a formatação, gravação ou bloqueio foram concluídos nesse caso.

O método não tem nenhum parâmetro de token de cancelamento. A chamada Close() de outro thread cancela a E/S bloqueada com IOException. Exceções da chamada síncrona são relatadas por meio da tarefa. A permissão NFC é necessária.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a