JsonObject Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class JsonObject final : IIterable<IKeyValuePair<winrt::hstring, IJsonValue const&>>, IMap<winrt::hstring, IJsonValue const&>, 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class JsonObject : IDictionary<string,IJsonValue>, IEnumerable<KeyValuePair<string,IJsonValue>>, 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>>, IStringablePublic NotInheritable Class JsonObject
Implements IDictionary(Of String, IJsonValue), IEnumerable(Of KeyValuePair(Of String, IJsonValue)), IStringable- Herencia
- Atributos
- 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. |