JSONObject Klasse

Definition

Namespace:: Org.Json

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.

Eine modifizierbare Gruppe von Namens-/Wertzuordnungen.

[Android.Runtime.Register("org/json/JSONObject", DoNotGenerateAcw=true)]
public class JSONObject : Java.Lang.Object

[<Android.Runtime.Register("org/json/JSONObject", DoNotGenerateAcw=true)>]
type JSONObject = class
    inherit Object

Vererbung: Object

JavaObject

Object
JSONObject

Attribute: RegisterAttribute

Hinweise

Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. Namen sind eindeutige, nicht NULL-Zeichenfolgen. Werte können eine beliebige Mischung aus JSONObject JSONObjects, , JSONArray JSONArraysZeichenfolgen, Booleans, Ganze Zahlen, Longs, Doubles oder #NULL. Werte dürfen nicht , null, Double#isNaN() NaNsDouble#isInfinite() infinitiesoder von typen, die hier nicht aufgeführt sind.

Diese Klasse kann Werte bei Bedarf in einen anderen Typ übertragen. <ul><li>Wenn der angeforderte Typ ein boolescher Wert ist, werden Zeichenfolgen mithilfe eines Vergleichs zwischen "true" und "false" koerciert. <li>Wenn der angeforderte Typ ein Double ist, werden andere Number Typen mithilfe von Number#doubleValue() doubleValue. Zeichenfolgen, die verwendet Double#valueOf(String) werden können, werden verwendet. <li>Wenn der angeforderte Typ ein Int ist, werden andere Number Typen mithilfe von Number#intValue() intValue. Zeichenfolgen, die verwendet Double#valueOf(String) werden können, werden umgewandelt und dann in "int" umgewandelt. <li>"lossy">Wenn der angeforderte Typ lang ist, werden andere <c>Number</c-Typen> mit <c>Number#longValue() longValue</c> umgewandelt. Zeichenfolgen, die mit <c>Double#valueOf(String)</c> umgewandelt werden können, werden in "long" umgewandelt. Diese zweistufige Konvertierung ist für sehr große Werte verloren. Beispielsweise gibt die Zeichenfolge "9223372036854775806" den langen 9223372036854775807 zurück.<li>Wenn der angeforderte Typ eine Zeichenfolge ist, werden andere Nicht-Null-Werte mithilfe String#valueOf(Object)von . Obwohl NULL nicht koerciert werden kann, wird der Sentinelwert JSONObject#NULL in die Zeichenfolge "null" umgewandelt. </ul>

Diese Klasse kann sowohl obligatorische als auch optionale Werte nachschlagen: <ul><li>Wird getType() verwendet, um einen obligatorischen Wert abzurufen. Dies schlägt bei einem JSONException Fehler fehl, wenn der angeforderte Name keinen Wert aufweist oder der Wert nicht mit dem angeforderten Typ umgewandelt werden kann. <li>Wird optType() verwendet, um einen optionalen Wert abzurufen. Dadurch wird ein Vom System oder vom Benutzer bereitgestellter Standardwert zurückgegeben, wenn der angeforderte Name keinen Wert aufweist oder der Wert nicht in den angeforderten Typ umgewandelt werden kann. </ul>

Warning: diese Klasse stellt null auf zwei inkompatible Methoden dar: der Standardverweis Java null Verweis und der SentinelwertJSONObject#NULL. Insbesondere entfernt der Aufruf put(name, null) den benannten Eintrag aus dem Objekt, speichert jedoch put(name, JSONObject.NULL) einen Eintrag, dessen Wert lautet JSONObject.NULL.

Instanzen dieser Klasse sind nicht threadsicher. Obwohl diese Klasse nichtfinal ist, wurde sie nicht für die Vererbung entwickelt und sollte nicht unterklassigt werden. Insbesondere wird die Selbstverwendung durch übersetzbare Methoden nicht angegeben. Weitere Informationen finden Sie unter "Effektive Java, 3. Auflage Artikel 19" "Entwurf und Dokument für Vererbung oder sonstiges Verbot".

Java Dokumentation für org.json.JSONObject.

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.

Konstruktoren

Name	Beschreibung
JSONObject()	Erstellt eine `JSONObject` Ohne Namens-/Wertzuordnungen.
JSONObject(IDictionary)	Erstellt eine neue `JSONObject` , indem alle Namens-/Wertzuordnungen aus der angegebenen Zuordnung kopiert werden.
JSONObject(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.
JSONObject(JSONObject, String[])	Erstellt eine neue `JSONObject` , indem Zuordnungen für die aufgelisteten Namen aus dem angegebenen Objekt kopiert werden.
JSONObject(JSONTokener)	Erstellt eine neue `JSONObject` mit Namens-/Wertzuordnungen aus dem nächsten Objekt im Tokener.
JSONObject(String)	Erstellt eine neue `JSONObject` mit Namens-/Wertzuordnungen aus der JSON-Zeichenfolge.

Eigenschaften

Name	Beschreibung
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
JniPeerMembers	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen.
Null	Ein Sentinelwert, der zum expliziten Definieren eines Namens ohne Wert verwendet wird.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Name	Beschreibung
Accumulate(String, Object)	Fügt `value` an das Array an, das bereits zugeordnet ist `name`.
Append(String, Object)	Fügt Werte an das Array an, das zugeordnet ist `name`.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
DisposeUnlessReferenced()	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
Equals(Object)	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
Get(String)	Gibt den wert zurück, der von `name`oder ausgelöst wird, wenn keine solche Zuordnung vorhanden ist.
GetBoolean(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein boolescher Wert ist oder in einen booleschen Wert umgewandelt oder andernfalls ausgelöst werden kann.
GetDouble(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein Double-Wert ist oder in einen Doppelwert umgewandelt werden kann oder andernfalls ausgelöst wird.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetInt(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein Int ist oder an einen Int umgewandelt werden kann oder andernfalls ausgelöst wird.
GetJSONArray(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein `JSONArray`oder andernfalls ausgelöst wird.
GetJSONObject(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein `JSONObject`oder andernfalls ausgelöst wird.
GetLong(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und eine lange ist oder zu einem langen oder andernfalls ausgelöst werden kann.
GetString(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist, es ggf. zu erercieren oder ausgelöst wird, wenn keine solche Zuordnung vorhanden ist.
Has(String)	Gibt true zurück, wenn dieses Objekt eine Zuordnung für `name`.
IsNull(String)	Gibt true zurück, wenn dieses Objekt keine Zuordnung hat `name` oder wenn es eine Zuordnung hat, deren Wert lautet `#NULL`.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Keys()	Gibt einen Iterator der `String` Namen in diesem Objekt zurück.
Length()	Gibt die Anzahl der Namens-/Wertzuordnungen in diesem Objekt zurück.
Names()	Gibt ein Array zurück, das die Zeichenfolgennamen in diesem Objekt enthält.
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
NumberToString(Number)	Codiert die Zahl als JSON-Zeichenfolge.
Opt(String)	Gibt den Wert zurück, der von `name`, oder NULL zugeordnet ist, wenn keine solche Zuordnung vorhanden ist.
OptBoolean(String, Boolean)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein boolescher Wert ist oder in einen booleschen Wert umgewandelt werden kann oder `fallback` andernfalls.
OptBoolean(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein boolescher Wert ist oder in einen booleschen Wert umgewandelt werden kann, oder auf andere Weise falsch.
OptDouble(String, Double)	Gibt den Wert zurück, `name` der `fallback` zugeordnet ist, wenn er vorhanden ist und ein Double-Wert ist oder in ein Doppel oder auf andere Weise umgewandelt werden kann.
OptDouble(String)	Gibt den Wert zurück, `name` der `NaN` zugeordnet ist, wenn er vorhanden ist und ein Double-Wert ist oder in ein Doppel oder auf andere Weise umgewandelt werden kann.
OptInt(String, Int32)	Gibt den Wert zurück, der zugeordnet `name` ist, wenn er vorhanden ist und ein Int ist oder in ein Int umgewandelt werden kann oder `fallback` anderweitig.
OptInt(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und ein Int ist oder in ein Int umgewandelt werden kann, oder 0 andernfalls.
OptJSONArray(String)	Gibt den Wert zurück, der zugeordnet ist, `name` wenn er vorhanden ist und ein `JSONArray`oder null ist.
OptJSONObject(String)	Gibt den Wert zurück, der zugeordnet ist, `name` wenn er vorhanden ist und ein `JSONObject`oder null ist.
OptLong(String, Int64)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und eine lange ist oder auf eine lange oder `fallback` auf andere Weise umgewandelt werden kann.
OptLong(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist und eine lange oder eine lange ist oder auf eine lange oder 0 auf andere Weise umgewandelt werden kann.
OptString(String, String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist, ihn ggf. erneut zu ernennen oder `fallback` wenn keine solche Zuordnung vorhanden ist.
OptString(String)	Gibt den Wert zurück, der `name` zugeordnet ist, wenn er vorhanden ist, es ggf. erneut erschreibt, oder die leere Zeichenfolge, wenn keine solche Zuordnung vorhanden ist.
Put(String, Boolean)	`name`Ordnet `value` alle vorhandenen Namens-/Wertzuordnungen mit demselben Namen zu , um die Zuordnung zu klonen.
Put(String, Double)	`name`Ordnet `value` alle vorhandenen Namens-/Wertzuordnungen mit demselben Namen zu , um die Zuordnung zu klonen.
Put(String, Int32)	`name`Ordnet `value` alle vorhandenen Namens-/Wertzuordnungen mit demselben Namen zu , um die Zuordnung zu klonen.
Put(String, Int64)	`name`Ordnet `value` alle vorhandenen Namens-/Wertzuordnungen mit demselben Namen zu , um die Zuordnung zu klonen.
Put(String, Object)	`name`Ordnet `value` alle vorhandenen Namens-/Wertzuordnungen mit demselben Namen zu , um die Zuordnung zu klonen.
PutOpt(String, Object)	Entspricht dem `put(name, value)` , wenn beide Parameter ungleich NULL sind; führt nichts anderes aus.
Quote(String)	`data` Codiert als JSON-Zeichenfolge.
Remove(String)	Entfernt die benannte Zuordnung, falls vorhanden; macht nichts anderes.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToJSONArray(JSONArray)	Gibt ein Array zurück, das den entsprechenden Werten entspricht `names`.
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
ToString(Int32)	Codiert dieses Objekt als lesbare JSON-Zeichenfolge für das Debuggen, z. B.:
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wrap(Object)	Umschließt das angegebene Objekt bei Bedarf.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen. (Geerbt von JavaObject)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Eine modifizierbare Gruppe von Namens-/Wertzuordnungen.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: