NdefRecord Classe

Définition

Espace de noms:: Android.Nfc

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un enregistrement NDEF immuable.

[Android.Runtime.Register("android/nfc/NdefRecord", DoNotGenerateAcw=true)]
public sealed class NdefRecord : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/nfc/NdefRecord", DoNotGenerateAcw=true)>]
type NdefRecord = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Héritage: Object

JavaObject

Object
NdefRecord

Attributs: RegisterAttribute

Implémente: IParcelable IJavaObject IJavaPeerable IDisposable

Remarques

Représente un enregistrement NDEF immuable.

NDEF (NFC Data Exchange Format) est un format binaire léger, utilisé pour encapsuler des données typées. Il est spécifié par le Forum NFC, pour la transmission et le stockage avec NFC, mais il est indépendant du transport.

NDEF définit les messages et les enregistrements. Un enregistrement NDEF contient des données typées, telles que des supports de type MIME, un URI ou une charge utile d’application personnalisée. Un message NDEF est un conteneur pour un ou plusieurs enregistrements NDEF.

Cette classe représente les enregistrements NDEF logiques (complets) et ne peut pas être utilisée pour représenter les enregistrements NDEF segmentés (partiels). Toutefois NdefMessage#NdefMessage(byte[]) , vous pouvez l’utiliser pour analyser un message contenant des enregistrements segmentés et retourner un message avec des enregistrements non bloqués (complets).

Un enregistrement NDEF logique contient toujours un TNF 3 bits (champ nom de type) qui fournit un type de niveau élevé pour le reste de l’enregistrement. Les champs restants sont de longueur variable et ne sont pas toujours présents : <ul><li>type : saisie détaillée de la charge utile</li><>id : identificateur meta-data, non couramment utilisé</li li em><><>payload : la charge utile< réelle/li></ul>

Les helpers tels que NdefRecord#createUri, NdefRecord#createMime et NdefRecord#createExternal sont inclus pour créer des enregistrements NDEF correctement mis en forme avec des champs tnf, type, id et charge utile, veuillez utiliser ces helpers chaque fois que possible.

Utilisez le constructeur #NdefRecord(short, byte[], byte[], byte[]) si vous savez ce que vous faites et ce qu’il faut définir individuellement les champs. Seule la validation de base est effectuée avec ce constructeur. Il est donc possible de créer des enregistrements qui ne confirment pas les spécifications strictes du forum NFC.

La représentation binaire d’un enregistrement NDEF inclut des indicateurs supplémentaires pour indiquer l’emplacement avec un message NDEF, fournir la prise en charge de la segmentation des enregistrements NDEF et de packer des champs facultatifs. Cette classe n’expose pas ces détails. Pour écrire un enregistrement NDEF en tant que fichier binaire, vous devez d’abord le placer dans un NdefMessage, puis appeler NdefMessage#toByteArray().

NdefMessage et NdefRecord les implémentations sont toujours disponibles, même sur les appareils Android qui n’ont pas de matériel NFC.

NdefRecordles s sont destinés à être immuables (et thread-safe), mais ils peuvent contenir des champs mutables. Veillez donc à ne pas modifier les champs mutables passés dans les constructeurs, ni modifier les champs mutables obtenus par les méthodes getter, sauf si cette modification est explicitement marquée comme sécurisée.

Java documentation pour android.nfc.NdefRecord.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Constructeurs

Nom	Description
NdefRecord(Byte[])	Obsolète. Créez un enregistrement NDEF à partir d’octets bruts.
NdefRecord(Int16, Byte[], Byte[], Byte[])	Créez un enregistrement NDEF à partir de ses champs de composant.

Champs

Nom	Description
TnfAbsoluteUri	Indique que le champ de type contient une construction BNF d’URI absolu définie par RFC 3986.
TnfEmpty	Indique que l’enregistrement est vide.
TnfExternalType	Indique que le champ de type contient un nom de type externe.
TnfMimeMedia	Indique que le champ de type contient une construction BNF de type média, définie par RFC 2046.
TnfUnchanged	Indique que la charge utile est un segment intermédiaire ou final d’un enregistrement NDEF segmenté.
TnfUnknown	Indique que le type de charge utile est inconnu.
TnfWellKnown	Indique que le champ de type contient un nom de type RTD connu.

Propriétés

Nom	Description
Class	Retourne la classe runtime de ce `Object`. (Hérité de Object)
Creator
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
JniIdentityHashCode	Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object)
JniManagedPeerState	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
JniPeerMembers	Représente un enregistrement NDEF immuable.
PeerReference	Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object)
RtdAlternativeCarrier	Type d’opérateur alternatif RTD.
RtdHandoverCarrier	Type transporteur de basculement RTD.
RtdHandoverRequest	Type de demande de transfert RTD.
RtdHandoverSelect	Type de sélection de handover RTD.
RtdSmartPoster	Type d’affiche intelligente RTD.
RtdText	Type de texte RTD.
RtdUri	Type d’URI RTD.
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)
Tnf	Retourne le TNF 3 bits.

Méthodes

Nom	Description
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
CreateApplicationRecord(String)	Créez un enregistrement d’application Android (AAR).
CreateExternal(String, String, Byte[])	Créez un enregistrement NDEF contenant des données externes (spécifiques à l’application).
CreateMime(String, Byte[])	Créez un enregistrement NDEF contenant des données MIME.
CreateTextRecord(String, String)	Créez un enregistrement NDEF contenant des données texte UTF-8.
CreateUri(String)	Créez un enregistrement NDEF contenant un URI.
CreateUri(Uri)	Créez un enregistrement NDEF contenant un URI.
DescribeContents()	Décrivez les types d’objets spéciaux contenus dans la représentation marshallée de ce Colisable.
Dispose()	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
Dispose(Boolean)	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
DisposeUnlessReferenced()	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
Equals(Object)	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetHashCode()	Retourne une valeur de code de hachage pour l’objet. (Hérité de Object)
GetId()	Retourne l’ID de longueur variable.
GetPayload()	Retourne la charge utile de longueur variable.
GetTypeInfo()	Retourne le champ Type de longueur variable.
JavaFinalize()	Obsolète. Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
ToArray<T>()	Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object)
ToByteArray()	Obsolète. Retournez cet enregistrement NDEF en tant que tableau d’octets.
ToMimeType()	Mappez cet enregistrement à un type MIME ou retournez null s’il ne peut pas être mappé.
ToString()	Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object)
ToUri()	Mappez cet enregistrement à un URI ou retournez null s’il ne peut pas être mappé.
UnregisterFromRuntime()	Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Aplatir cet objet dans un colis.

Implémentations d’interfaces explicites

Nom	Description
IJavaPeerable.Disposed()	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
IJavaPeerable.Finalized()	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Représente un enregistrement NDEF immuable. (Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Représente un enregistrement NDEF immuable.

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Représente un enregistrement NDEF immuable.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à