JsonObject Clase

Definición

Espacio de nombres:

Windows.Data.Json

Representa un objeto JSON que contiene una colección de pares nombre y JsonValue .

JsonObject es una clase activable que implementa JsonValue y la interfaz IMap<String,IJsonValue> de forma que sus pares nombre-valor se pueden manipular como un diccionario. Cuando haya valores con nombres duplicados, se almacenará el par de apellidos y valores.

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

Herencia

Object Platform::Object IInspectable JsonObject

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

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 de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Para obtener un ejemplo de cómo se usan estos métodos de clase para analizar un objeto de una cadena JSON y convertirlo en un objeto JsonObject, actualizar los pares de nombre y valor que contiene el objeto y, a continuación, serializar el objeto JsonObject actualizado como una cadena JSON, vea Using JavaScript Object Notation (JSON).

Constructores

JsonObject()

Inicializa una nueva instancia de jsonObject que representa un objeto JSON que contiene una colección de pares nombre y JsonValue .

Propiedades

Size	Obtiene el tamaño (recuento) de la colección.
ValueType	Obtiene el tipo del valor JSON encapsulado. Los tipos posibles se definen mediante JsonValueType.

Métodos

Clear()	Quita todos los elementos de la colección.
First()	Devuelve el iterador para la iteración en los pares clave-valor del objeto JsonObject.
GetArray()	Devuelve jsonArray si valueType del valor encapsulado es Array.
GetBoolean()	Obtiene un valor booleano si valueType del valor encapsulado es booleano.
GetNamedArray(String)	Obtiene el valor jsonArray con el nombre especificado.
GetNamedArray(String, JsonArray)	Obtiene el valor JsonArray con el nombre especificado o el valor predeterminado proporcionado si no se encuentra dicho valor con nombre.
GetNamedBoolean(String)	Obtiene el valor booleano con el nombre especificado.
GetNamedBoolean(String, Boolean)	Obtiene el valor booleano con el nombre especificado o el valor predeterminado proporcionado si no se encuentra dicho valor con nombre.
GetNamedNumber(String)	Obtiene el valor numérico (un valor Double) con el nombre especificado.
GetNamedNumber(String, Double)	Obtiene el valor numérico (un valor Double) con el nombre especificado o el valor predeterminado proporcionado si no se encuentra dicho valor con nombre.
GetNamedObject(String)	Obtiene el valor JsonObject con el nombre especificado.
GetNamedObject(String, JsonObject)	Obtiene el valor JsonObject con el nombre especificado o el valor predeterminado proporcionado si no se encuentra dicho valor con nombre.
GetNamedString(String)	Obtiene el valor string con el nombre especificado.
GetNamedString(String, String)	Obtiene el valor string con el nombre especificado o el valor predeterminado proporcionado si no se encuentra dicho valor con nombre.
GetNamedValue(String)	Obtiene el valor JsonValue con el nombre especificado.
GetNamedValue(String, JsonValue)	Obtiene el valor JsonValue especificado o el valor predeterminado proporcionado si no se encuentra ningún valor con nombre.
GetNumber()	Obtiene el número (un valor Double) si valueType del valor encapsulado es Number.
GetObject()	Obtiene jsonObject si valueType del valor encapsulado es Object.
GetString()	Obtiene la cadena si valueType del valor encapsulado es String.
GetView()	Obtiene una vista JsonObject .
HasKey(String)	Indica si JsonObject tiene una entrada con la clave solicitada.
Insert(String, IJsonValue)	Agrega una nueva entrada al objeto JsonObject.
Lookup(String)	Obtiene el valor JSON asociado a la clave proporcionada, si existe una entrada con esa clave.
Parse(String)	Analiza la cadena JSON especificada que representa un JsonObject en un valor JSON. Nota Esto producirá una excepción si la cadena JSON proporcionada no es válida. El uso de JsonObject.TryParse es una alternativa recomendada. Una llamada a TryParse devolverá un valor booleano para indicar si se ha realizado correctamente y, si se ejecuta correctamente, el jsonObject resultante.
Remove(String)	Quita un elemento específico del objeto JsonObject.
SetNamedValue(String, IJsonValue)	Establece el valor del primer objeto JsonValue con el nombre especificado en el valor especificado. Si no se encuentra este objeto, se inserta un nuevo nombre y un par JsonValue en el objeto JSON.
Stringify()	Recupera la representación JSON del valor encapsulado.
ToString()	Recupera la representación JSON del valor encapsulado.
TryParse(String, JsonObject)	Analiza la cadena especificada que representa un objeto JSON en un JsonObject.

Consulte también

• Uso de notación de objetos JavaScript (JSON)
• Ejemplo json (Windows 10)