JsonObject Classe

Definição

Namespace:

Windows.Data.Json

Representa um objeto JSON que contém uma coleção de pares name e JsonValue .

JsonObject é uma classe ativável que implementa JsonValue e a interface IMap<String,IJsonValue de> modo que seus pares nome/valor possam ser manipulados como um dicionário. Quando houver valores com nomes duplicados, o par sobrenome/valor será armazenado.

public ref class JsonObject sealed : IIterable<IKeyValuePair<Platform::String ^, IJsonValue ^> ^>, IMap<Platform::String ^, IJsonValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class JsonObject final : IIterable<IKeyValuePair<winrt::hstring, IJsonValue const&>>, IMap<winrt::hstring, IJsonValue const&>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class JsonObject : IDictionary<string,IJsonValue>, IEnumerable<KeyValuePair<string,IJsonValue>>, IStringable

Public NotInheritable Class JsonObject
Implements IDictionary(Of String, IJsonValue), IEnumerable(Of KeyValuePair(Of String, IJsonValue)), IStringable

Herança

Object Platform::Object IInspectable JsonObject

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IDictionary<String,IJsonValue> IMap<Platform::String,IJsonValue> IMap<winrt::hstring,IJsonValue> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IEnumerable<KeyValuePair<String,IJsonValue>> IIterable<IKeyValuePair<Platform::String,IJsonValue>> IIterable<IKeyValuePair<winrt::hstring,IJsonValue>> IJsonValue IStringable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Para obter um exemplo de como esses métodos de classe são usados para analisar um objeto de uma cadeia de caracteres JSON e convertê-lo em um objeto JsonObject, atualize os pares nome/valor que o objeto contém e, em seguida, serialize o objeto JsonObject atualizado como uma cadeia de caracteres JSON, consulte Using JavaScript Object Notation (JSON).

Construtores

JsonObject()

Inicializa uma nova instância de um JsonObject que representa um objeto JSON que contém uma coleção de pares name e JsonValue .

Propriedades

Size	Obtém o tamanho (contagem) da coleção.
ValueType	Obtém o tipo do valor JSON encapsulado. Os tipos possíveis são definidos por JsonValueType.

Métodos

Clear()	Remove todos os itens da coleção.
First()	Retorna o iterador para iteração sobre os pares chave/valor no JsonObject.
GetArray()	Retorna um JsonArray se o ValueType do valor encapsulado for Array.
GetBoolean()	Obtém um Boolean se o ValueType do valor encapsulado for booliano.
GetNamedArray(String)	Obtém o valor JsonArray com o nome especificado.
GetNamedArray(String, JsonArray)	Obtém o valor JsonArray com o nome especificado ou o valor padrão fornecido se nenhum valor nomeado for encontrado.
GetNamedBoolean(String)	Obtém o valor booliano com o nome especificado.
GetNamedBoolean(String, Boolean)	Obtém o valor booliano com o nome especificado ou o valor padrão fornecido se nenhum valor nomeado for encontrado.
GetNamedNumber(String)	Obtém o valor numérico (um Double) com o nome especificado.
GetNamedNumber(String, Double)	Obtém o valor numérico (um Double) com o nome especificado ou o valor padrão fornecido se nenhum valor nomeado for encontrado.
GetNamedObject(String)	Obtém o valor JsonObject com o nome especificado.
GetNamedObject(String, JsonObject)	Obtém o valor JsonObject com o nome especificado ou o valor padrão fornecido se nenhum valor nomeado for encontrado.
GetNamedString(String)	Obtém o valor String com o nome especificado.
GetNamedString(String, String)	Obtém o valor String com o nome especificado ou o valor padrão fornecido se nenhum valor nomeado for encontrado.
GetNamedValue(String)	Obtém o valor JsonValue com o nome especificado.
GetNamedValue(String, JsonValue)	Obtém o valor JsonValue especificado ou o valor padrão fornecido se nenhum valor nomeado for encontrado.
GetNumber()	Obtém o número (um Duplo) se o ValueType do valor encapsulado for Number.
GetObject()	Obtém o JsonObject se o ValueType do valor encapsulado for Object.
GetString()	Obtém a Cadeia de Caracteres se o ValueType do valor encapsulado for String.
GetView()	Obtém uma exibição JsonObject .
HasKey(String)	Indica se o JsonObject tem uma entrada com a chave solicitada.
Insert(String, IJsonValue)	Adiciona uma nova entrada ao JsonObject.
Lookup(String)	Obtém o valor JSON associado à chave fornecida, se houver uma entrada com essa chave.
Parse(String)	Analisa a cadeia de caracteres JSON especificada que representa um JsonObject em um valor JSON. Observação Isso gerará uma exceção se a cadeia de caracteres JSON fornecida não for válida. O uso de JsonObject.TryParse é uma alternativa recomendada. Uma chamada TryParse retornará um valor booliano para indicar êxito ou falha e, se bem-sucedido, o JsonObject resultante.
Remove(String)	Remove um item específico do JsonObject.
SetNamedValue(String, IJsonValue)	Define o valor do primeiro objeto JsonValue com o nome especificado como o valor especificado. Se nenhum objeto desse tipo for encontrado, um novo nome e um par JsonValue serão inseridos no objeto JSON.
Stringify()	Recupera a representação JSON do valor encapsulado.
ToString()	Recupera a representação JSON do valor encapsulado.
TryParse(String, JsonObject)	Analisa a cadeia de caracteres especificada que representa um objeto JSON em um JsonObject.

Confira também

• Usando a JSON (JavaScript Object Notation)
• Exemplo de JSON (Windows 10)