NdefRecord.CreateExternal(String, String, Byte[]) Methode

Definition

Namespace:: Android.Nfc

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellen Sie einen neuen NDEF-Eintrag, der externe (anwendungsspezifische) Daten enthält.

[Android.Runtime.Register("createExternal", "(Ljava/lang/String;Ljava/lang/String;[B)Landroid/nfc/NdefRecord;", "")]
public static Android.Nfc.NdefRecord? CreateExternal(string? domain, string? type, byte[]? data);

[<Android.Runtime.Register("createExternal", "(Ljava/lang/String;Ljava/lang/String;[B)Landroid/nfc/NdefRecord;", "")>]
static member CreateExternal : string * string * byte[] -> Android.Nfc.NdefRecord

Parameter

domain: String

Domänenname der ausstellenden Organisation

type: String

domänenspezifischer Datentyp

data: Byte[]

Nutzlast als Bytes

Gibt zurück

NdefRecord

Attribute: RegisterAttribute

Hinweise

Erstellen Sie einen neuen NDEF-Eintrag, der externe (anwendungsspezifische) Daten enthält.

Verwenden Sie diese Methode, um anwendungsspezifische Daten in einen NDEF-Eintrag zu codieren. Die Daten werden durch einen Domänennamen (in der Regel Ihr Android-Paketname) und einen domänenspezifischen Typ eingegeben. Diese Daten werden in einen NDEF-Eintrag "NFC Forum External Type" verpackt.

Das NFC-Forum erfordert, dass die domäne und der Typ, die in einem externen Datensatz verwendet wird, als Groß-/Kleinschreibung behandelt werden. Bei der Android-Absichtsfilterung wird jedoch immer die Groß-/Kleinschreibung beachtet. Daher erzwingt diese Methode die Domäne und den Typ vor dem Erstellen des NDEF-Eintrags in Kleinbuchstaben.

Die deaktivierte Ausnahme IllegalArgumentException wird ausgelöst, wenn die Domäne und der Typ schwerwiegende Probleme haben, z. B. wenn eines der Felder leer ist, also immer diese Ausnahme abfangen, wenn Sie vom Benutzer generierte Daten an diese Methode übergeben.

Es gibt keine solchen Einschränkungen für die Nutzlastdaten.

Aus Effizienzgründen stellt diese Methode möglicherweise keine interne Kopie des Datenbytearrays dar. Achten Sie daher darauf, das Datenbytearray nicht zu ändern, während sie weiterhin den zurückgegebenen NdefRecord verwenden.

Referenzspezifikation: NFCForum-TS-RTD_1.0

Java Dokumentation für android.nfc.NdefRecord.createExternal(java.lang.String, java.lang.String, byte[]).

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: