NdefFormatable.FormatReadOnly(NdefMessage) Method

Definition

Formats a tag as NDEF, write a NdefMessage, and make read-only.

[Android.Runtime.Register("formatReadOnly", "(Landroid/nfc/NdefMessage;)V", "")]
public void FormatReadOnly (Android.Nfc.NdefMessage? firstMessage);
[<Android.Runtime.Register("formatReadOnly", "(Landroid/nfc/NdefMessage;)V", "")>]
member this.FormatReadOnly : Android.Nfc.NdefMessage -> unit

Parameters

firstMessage
NdefMessage

the NDEF message to write after formatting

Attributes

Exceptions

if the tag leaves the field

if there is an I/O failure, or the operation is canceled

if the NDEF Message to write is malformed

Remarks

Formats a tag as NDEF, write a NdefMessage, and make read-only.

This is a multi-step process, an IOException is thrown if any one step fails.

The card is left in a read-only state if this method returns successfully.

This is an I/O operation and will block until complete. It must not be called from the main application thread. A blocked call will be canceled with IOException if #close is called from another thread.

<p class="note">Requires the android.Manifest.permission#NFC permission.

Java documentation for android.nfc.tech.NdefFormatable.formatReadOnly(android.nfc.NdefMessage).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to