JSONObject Classe
Définition
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.
Ensemble modifiable de mappages nom/valeur.
[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
- Héritage
- Attributs
Remarques
Ensemble modifiable de mappages nom/valeur. Les noms sont des chaînes uniques et non null. Les valeurs peuvent être n’importe quel mélange de JSONObject JSONObjects, JSONArray JSONArrayschaînes, booléens, entiers, longs, doubles ou #NULL. Les valeurs ne peuvent pas être null, Double#isNaN() NaNsou Double#isInfinite() infinitiesde tout type non répertorié ici.
Cette classe peut forcer les valeurs vers un autre type quand elle est demandée.
<ul><li>Lorsque le type demandé est une valeur booléenne, les chaînes sont coercées à l’aide d’une comparaison non sensible à la casse à « true » et « false ».
<li>Lorsque le type demandé est un double, d’autres Number types sont coéchés à l’aide Number#doubleValue() doubleValuede . Les chaînes qui peuvent être coercées à l’aide Double#valueOf(String) seront.
<li>Lorsque le type demandé est un int, d’autres Number types sont coerced à l’aide Number#intValue() intValuede . Les chaînes qui peuvent être coercées à l’aide Double#valueOf(String) seront, puis castées en int. <li>"lossy">Lorsque le type demandé est long, d’autres <types c>Number</c> sont coerced à l’aide <de c>Number#longValue() longValue</c>. Les chaînes qui peuvent être coercées à l’aide <de c>Double#valueOf(String)</c> seront converties en longues. Cette conversion en deux étapes est perdue pour des valeurs très volumineuses. Par exemple, la chaîne « 9223372036854775806 » génère la longue 9223372036854775807.<li>Lorsque le type demandé est une chaîne, d’autres valeurs non null sont coéchées à l’aide String#valueOf(Object)de . Bien que null ne puisse pas être coerced, la valeur JSONObject#NULL sentinelle est coerced sur la chaîne « null ».
</ul>
Cette classe peut rechercher des valeurs obligatoires et facultatives : <ul><li>Use get<i>Type</i>() pour récupérer une valeur obligatoire. Cela échoue avec une JSONException valeur si le nom demandé n’a pas de valeur ou si la valeur ne peut pas être coéchée au type demandé.
<li>Use opt<i>Type</i>() pour récupérer une valeur facultative. Cette opération renvoie une valeur par défaut fournie par le système ou l’utilisateur si le nom demandé n’a aucune valeur ou si la valeur ne peut pas être coerctée au type demandé.
</ul>
<
>strong Warning :</strong> cette classe représente null de deux façons incompatibles : la référence Java null standard et la valeur JSONObject#NULLsentinelle . En particulier, l’appel put(name, null) supprime l’entrée nommée de l’objet, mais put(name, JSONObject.NULL) stocke une entrée dont la valeur est JSONObject.NULL.
Les instances de cette classe ne sont pas thread-safe. Bien que cette classe ne soit pas finale, elle n’a pas été conçue pour l’héritage et ne doit pas être sous-classée. En particulier, l’auto-utilisation par les méthodes substituables n’est pas spécifiée. Pour plus d’informations, voir Effective Java, 3e édition, article 19, « Conception et document pour l’héritage ou autre interdiction ».
Java documentation pour org.json.JSONObject.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Constructeurs
| Nom | Description |
|---|---|
| JSONObject() |
Crée un |
| JSONObject(IDictionary) |
Crée un nouveau |
| JSONObject(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
| JSONObject(JSONObject, String[]) |
Crée un nouveau |
| JSONObject(JSONTokener) |
Crée un nouveau |
| JSONObject(String) |
Crée un nouveau |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| 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 |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| JniPeerMembers |
Ensemble modifiable de mappages nom/valeur. |
| Null |
Valeur sentinelle utilisée pour définir explicitement un nom sans valeur. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| 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. |
| 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. |
Méthodes
| Nom | Description |
|---|---|
| Accumulate(String, Object) |
|
| Append(String, Object) |
Ajoute des valeurs au tableau mappé à |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| 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() |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| Equals(Object) |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Get(String) |
Retourne la valeur mappée par |
| GetBoolean(String) |
Retourne la valeur mappée s’il |
| GetDouble(String) |
Retourne la valeur mappée s’il |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| GetInt(String) |
Retourne la valeur mappée s’il |
| GetJSONArray(String) |
Retourne la valeur mappée s’il |
| GetJSONObject(String) |
Retourne la valeur mappée s’il |
| GetLong(String) |
Retourne la valeur mappée s’il |
| GetString(String) |
Retourne la valeur mappée s’il |
| Has(String) |
Retourne true si cet objet a un mappage pour |
| IsNull(String) |
Retourne true si cet objet n’a pas de mappage ou |
| JavaFinalize() |
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) |
| Keys() |
Retourne un itérateur des noms dans |
| Length() |
Retourne le nombre de mappages nom/valeur dans cet objet. |
| Names() |
Retourne un tableau contenant les noms de chaînes dans cet objet. |
| 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) |
| NumberToString(Number) |
Encode le nombre sous forme de chaîne JSON. |
| Opt(String) |
Retourne la valeur mappée par |
| OptBoolean(String, Boolean) |
Retourne la valeur mappée s’il |
| OptBoolean(String) |
Retourne la valeur mappée s’il |
| OptDouble(String, Double) |
Retourne la valeur mappée s’il |
| OptDouble(String) |
Retourne la valeur mappée s’il |
| OptInt(String, Int32) |
Retourne la valeur mappée s’il |
| OptInt(String) |
Retourne la valeur mappée s’il |
| OptJSONArray(String) |
Retourne la valeur mappée s’il |
| OptJSONObject(String) |
Retourne la valeur mappée s’il |
| OptLong(String, Int64) |
Retourne la valeur mappée s’il |
| OptLong(String) |
Retourne la valeur mappée s’il |
| OptString(String, String) |
Retourne la valeur mappée s’il |
| OptString(String) |
Retourne la valeur mappée si |
| Put(String, Boolean) |
Mappe |
| Put(String, Double) |
Mappe |
| Put(String, Int32) |
Mappe |
| Put(String, Int64) |
Mappe |
| Put(String, Object) |
Mappe |
| PutOpt(String, Object) |
Équivaut au |
| Quote(String) |
Encode en |
| Remove(String) |
Supprime le mappage nommé s’il existe ; ne fait rien d’autre. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToJSONArray(JSONArray) |
Retourne un tableau avec les valeurs correspondant à |
| ToString() |
Retourne une représentation de chaîne de l'objet. (Hérité de Object) |
| ToString(Int32) |
Encode cet objet en tant que chaîne JSON lisible par l’homme pour le débogage, par exemple : |
| 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) |
| Wrap(Object) |
Encapsule l’objet donné si nécessaire. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Ensemble modifiable de mappages nom/valeur. (Hérité de JavaObject) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Ensemble modifiable de mappages nom/valeur. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |