JSONObject Classe

Definição

Namespace:

Org.Json

Assembly:

Mono.Android.dll

Um conjunto modificável de mapeamentos de nome/valor.

[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

Herança

Object

JavaObject

Object

JSONObject

Atributos

RegisterAttribute

Comentários

Um conjunto modificável de mapeamentos de nome/valor. Os nomes são cadeias de caracteres exclusivas e não nulas. Os valores podem ser qualquer combinação de JSONObject JSONObjects, JSONArray JSONArraysStrings, Booleans, Integers, Longs, Doubles ou #NULL. Os valores podem não ser null, Double#isNaN() NaNsou Double#isInfinite() infinitiesde qualquer tipo não listado aqui.

Essa classe pode coagir valores a outro tipo quando solicitado. <ul><li>Quando o tipo solicitado for um booliano, as cadeias de caracteres serão coagidas usando uma comparação que não diferencia maiúsculas de minúsculas como "true" e "false". <li>Quando o tipo solicitado for um duplo, outros Number tipos serão coagidos usando Number#doubleValue() doubleValue. As cadeias de caracteres que podem ser coagidas a usar Double#valueOf(String) serão. <li>Quando o tipo solicitado for um int, outros Number tipos serão coagidos usando Number#intValue() intValue. Cadeias de caracteres que podem ser coagidas usando Double#valueOf(String) serão e, em seguida, convertidas em int. <li>"lossy">Quando o tipo solicitado for longo, outros <tipos c>Number</c> serão coagidos usando <c>Number#longValue() longValue</c>. Cadeias de caracteres que podem ser coagidas usando <c>Double#valueOf(String)</c> serão e, em seguida, convertidas em long. Essa conversão de duas etapas é perdida para valores muito grandes. Por exemplo, a cadeia de caracteres "9223372036854775806" produz a 9223372036854775807 longa.<li>Quando o tipo solicitado for uma cadeia de caracteres, outros valores não nulos serão coagidos usando String#valueOf(Object). Embora nulo não possa ser coagido, o valor JSONObject#NULL sentinela é coagido à cadeia de caracteres "nula". </ul>

Essa classe pode pesquisar valores obrigatórios e opcionais: <ul><li>Use get<i>Type</i>() para recuperar um valor obrigatório. Isso falhará com um JSONException se o nome solicitado não tiver nenhum valor ou se o valor não puder ser coagido ao tipo solicitado. <li>Use opt<i>Type</i>() para recuperar um valor opcional. Isso retornará um padrão fornecido pelo sistema ou pelo usuário se o nome solicitado não tiver nenhum valor ou se o valor não puder ser coagido ao tipo solicitado. </ul>

<aviso forte>:</strong> essa classe representa nulo de duas maneiras incompatíveis: a referência de Java null padrão e o valor JSONObject#NULLsentinela. Em particular, a chamada put(name, null) remove a entrada nomeada do objeto, mas put(name, JSONObject.NULL) armazena uma entrada cujo valor é JSONObject.NULL.

As instâncias dessa classe não são thread-safe. Embora essa classe não seja final, ela não foi projetada para herança e não deve ser subclasse. Em particular, o autoutilizamento por métodos substituíveis não é especificado. Consulte o Effective Java, item 19 da 3ª edição, "Design e Documento para herança ou então proíba" para obter mais informações.

Java documentação para org.json.JSONObject.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome	Description
JSONObject()	Cria um JSONObject mapeamento sem nome/valor.
JSONObject(IDictionary)	Cria um novo JSONObject copiando todos os mapeamentos de nome/valor do mapa fornecido.
JSONObject(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.
JSONObject(JSONObject, String[])	Cria um novo JSONObject copiando mapeamentos para os nomes listados do objeto fornecido.
JSONObject(JSONTokener)	Cria um novo JSONObject com mapeamentos de nome/valor do próximo objeto no tokener.
JSONObject(String)	Cria um novo JSONObject com mapeamentos de nome/valor da cadeia de caracteres JSON.

Propriedades

Nome	Description
Class	Retorna a classe de tempo de execução deste Object. (Herdado de Object)
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
JniPeerMembers	Um conjunto modificável de mapeamentos de nome/valor.
Null	Um valor sentinela usado para definir explicitamente um nome sem valor.
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
ThresholdClass	Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.

Métodos

Nome	Description
Accumulate(String, Object)	value Acrescenta à matriz já mapeada para name.
Append(String, Object)	Acrescenta valores à matriz mapeada para name.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
Equals(Object)	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
Get(String)	Retorna o valor mapeado por name, ou é gerado se nenhum mapeamento desse tipo existir.
GetBoolean(String)	Retorna o valor mapeado se name ele existir e for um booliano ou pode ser coagido a um booliano ou é lançado de outra forma.
GetDouble(String)	Retorna o valor mapeado se name ele existir e for um duplo ou pode ser coagido a um duplo ou gerar o contrário.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetInt(String)	Retorna o valor mapeado se name ele existir e for um int ou pode ser coagido a um int ou é gerado de outra forma.
GetJSONArray(String)	Retorna o valor mapeado se name ele existir e for um JSONArrayou gerar o contrário.
GetJSONObject(String)	Retorna o valor mapeado se name ele existir e for um JSONObjectou gerar o contrário.
GetLong(String)	Retorna o valor mapeado se name ele existir e for longo ou pode ser coagido a um longo ou gerar o contrário.
GetString(String)	Retorna o valor mapeado se name existir, coagindo-o, se necessário, ou será gerado se não existir nenhum mapeamento desse tipo.
Has(String)	Retornará true se esse objeto tiver um mapeamento para name.
IsNull(String)	Retornará true se este objeto não tiver nenhum mapeamento para name ou se ele tiver um mapeamento cujo valor é #NULL.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
Keys()	Retorna um iterador dos String nomes neste objeto.
Length()	Retorna o número de mapeamentos de nome/valor neste objeto.
Names()	Retorna uma matriz que contém os nomes de cadeia de caracteres neste objeto.
Notify()	Ativa um único thread que está aguardando no monitor desse objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
NumberToString(Number)	Codifica o número como uma cadeia de caracteres JSON.
Opt(String)	Retorna o valor mapeado por name, ou nulo, se nenhum mapeamento desse tipo existir.
OptBoolean(String, Boolean)	Retorna o valor mapeado se name ele existir e for um booliano ou pode ser coagido a um booliano ou fallback não.
OptBoolean(String)	Retorna o valor mapeado se name ele existir e for um booliano ou pode ser coagido a um booliano ou false caso contrário.
OptDouble(String, Double)	Retorna o valor mapeado se name ele existir e for um duplo ou pode ser coagido a um duplo ou fallback não.
OptDouble(String)	Retorna o valor mapeado se name ele existir e for um duplo ou pode ser coagido a um duplo ou NaN não.
OptInt(String, Int32)	Retorna o valor mapeado se name ele existir e for um int ou pode ser coagido a um int ou fallback não.
OptInt(String)	Retorna o valor mapeado se name ele existir e for um int ou pode ser coagido a um int ou 0 de outra forma.
OptJSONArray(String)	Retorna o valor mapeado se name ele existir e for um JSONArray, ou nulo, caso contrário.
OptJSONObject(String)	Retorna o valor mapeado se name ele existir e for um JSONObject, ou nulo, caso contrário.
OptLong(String, Int64)	Retorna o valor mapeado se name existir e for longo ou pode ser coagido a um longo ou fallback não.
OptLong(String)	Retorna o valor mapeado se name ele existir e for longo ou pode ser coagido a um longo ou 0 de outra forma.
OptString(String, String)	Retorna o valor mapeado se name existir, coagindo-o, se necessário, ou fallback se nenhum mapeamento desse tipo existir.
OptString(String)	Retorna o valor mapeado se name existir, coagindo-o, se necessário, ou a cadeia de caracteres vazia se não existir nenhum mapeamento desse tipo.
Put(String, Boolean)	Mapeia name para value, clobbering qualquer mapeamento de nome/valor existente com o mesmo nome.
Put(String, Double)	Mapeia name para value, clobbering qualquer mapeamento de nome/valor existente com o mesmo nome.
Put(String, Int32)	Mapeia name para value, clobbering qualquer mapeamento de nome/valor existente com o mesmo nome.
Put(String, Int64)	Mapeia name para value, clobbering qualquer mapeamento de nome/valor existente com o mesmo nome.
Put(String, Object)	Mapeia name para value, clobbering qualquer mapeamento de nome/valor existente com o mesmo nome.
PutOpt(String, Object)	Equivalente a put(name, value) quando ambos os parâmetros não são nulos; não faz nada de outra forma.
Quote(String)	Codifica como uma cadeia de caracteres data JSON.
Remove(String)	Remove o mapeamento nomeado se ele existir; não faz nada de outra forma.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToJSONArray(JSONArray)	Retorna uma matriz com os valores correspondentes a names.
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
ToString(Int32)	Codifica esse objeto como uma cadeia de caracteres JSON legível humana para depuração, como:
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até que seja despertado, normalmente sendo <notificado></em> ou <em>interrompido</em>. (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <notificado></em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <notificado></em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wrap(Object)	Encapsula o objeto fornecido, se necessário.

Implantações explícitas de interface

Nome	Description
IJavaPeerable.Disposed()	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
IJavaPeerable.Finalized()	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Um conjunto modificável de mapeamentos de nome/valor. (Herdado de JavaObject)

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância self.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada pelo tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Um conjunto modificável de mapeamentos de nome/valor.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.