Sprache

NdefFormatable.FormatReadOnlyAsync(NdefMessage) Methode

Definition

Formatiert das Tag für NDEF, schreibt optional eine Nachricht und macht das Tag in einem Threadpoolthread schreibgeschützt.

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

Parameter

firstMessage
NdefMessage

Die NDEF-Nachricht, die nach der Formatierung geschrieben werden soll, oder null das Schreiben der Nachricht zu überspringen, bevor das Tag schreibgeschützt wird.

Gibt zurück

Eine Aufgabe, die den Aufruf darstellt FormatReadOnly(NdefMessage).

Hinweise

Dieser verwaltete Wrapper wird zum Aufrufen FormatReadOnly(NdefMessage)verwendetTask.Run. Stellen Sie zuerst eine Verbindung her, und warten Sie die Aufgabe, bevor Sie einen anderen Vorgang starten. Das Schreibschutztag ist unumkehrbar. Formatierung, Schreiben und Sperren sind separate Schritte; Bei einem späteren Fehler wird kein früherer Schritt rückgängig.

Wenn der NFC-Dienst während des Anrufs stirbt, protokolliert die angeheftete Android-Implementierung die RemoteException und gibt diese zurück, ohne ihn zu auslösen. Der Vorgangsabschluss allein bestätigt nicht, dass formatierung, schreiben oder sperren in diesem Fall abgeschlossen ist.

Die Methode weist keinen Abbruchtokenparameter auf. Das Aufrufen Close() von einem anderen Thread bricht blockierte E/A mit IOException. Ausnahmen vom synchronen Aufruf werden über die Aufgabe gemeldet. Die NFC-Berechtigung ist erforderlich.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: