JsonArray Clase

Definición

Espacio de nombres:

Windows.Data.Json

Representa una matriz JSON.

JsonArray hereda las interfaces IVector(IJsonValue) e IIterable(IJsonValue), que proporcionan métodos para recorrer en iteración los elementos de la matriz y actualizar su contenido.

public ref class JsonArray sealed : IIterable<IJsonValue ^>, IVector<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 JsonArray final : IIterable<IJsonValue>, IVector<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 JsonArray : IEnumerable<IJsonValue>, IList<IJsonValue>, IStringable

Public NotInheritable Class JsonArray
Implements IEnumerable(Of IJsonValue), IList(Of IJsonValue), IStringable

Herencia

Object Platform::Object IInspectable JsonArray

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IIterable<T> IEnumerable<T> IIterable<IJsonValue> IEnumerable<IJsonValue> IVector<IJsonValue> IList<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 una matriz de una cadena JSON y convertirlo en un objeto JsonArray, actualizar los valores que contiene la matriz y, a continuación, serializar el objeto JsonArray actualizado como una cadena JSON, consulte Uso de notación de objetos JavaScript (JSON).

Enumeración de la colección en C# o Microsoft Visual Basic

JsonArray es enumerable, por lo que puede usar sintaxis específica del lenguaje, como foreach en C# para enumerar los elementos de la colección. El compilador realiza la conversión de tipos automáticamente y no es necesario convertir a IEnumerable<IJsonValue> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta a IEnumerable<T> con una restricción IJsonValue .

Constructores

JsonArray()

Crea un nuevo objeto JsonArray que representa una matriz JSON.

Propiedades

Size	Obtiene el tamaño (recuento) de la matriz.
ValueType	Obtiene el tipo de los valores de la matriz. Los tipos posibles se definen mediante JsonValueType.

Métodos

Append(IJsonValue)	Agrega un nuevo elemento a la matriz.
Clear()	Quita todos los elementos de la colección.
First()	Devuelve el iterador para la iteración sobre los elementos de la matriz.
GetArray()	Obtiene JsonArray si valueType del valor encapsulado es Array.
GetArrayAt(UInt32)	Obtiene jsonArray en el índice especificado si valueType del valor encapsulado es Array .
GetAt(UInt32)	Devuelve el elemento ubicado en el índice especificado.
GetBoolean()	Obtiene el valor booleano si valueType del valor encapsulado es booleano.
GetBooleanAt(UInt32)	Obtiene el valor booleano en el índice especificado si valueType del valor en ese índice es booleano.
GetMany(UInt32, IJsonValue[])	Obtiene todos los elementos de matriz de tipo IJsonValue, empezando por un índice especificado.
GetNumber()	Obtiene el número (un valor Double) si valueType del valor encapsulado es Number.
GetNumberAt(UInt32)	Obtiene el número (un valor Double) en el índice especificado si valueType del valor en ese índice es Number.
GetObject()	Obtiene el objeto JsonObject si valueType del valor encapsulado es Object.
GetObjectAt(UInt32)	Obtiene el JsonObject en el índice especificado si valueType del valor encapsulado es Object.
GetString()	Obtiene la cadena si valueType del valor encapsulado es String.
GetStringAt(UInt32)	Obtiene la cadena en el índice especificado si valueType del valor encapsulado es String.
GetView()	Obtiene una vista JsonArray .
IndexOf(IJsonValue, UInt32)	Busca un objeto JsonValue y devuelve el índice de base cero de su primera aparición en JsonArray.
InsertAt(UInt32, IJsonValue)	Inserta un JsonValue en una matriz en el índice especificado.
Parse(String)	Analiza la cadena JSON especificada que representa una JsonArray. Nota Este método producirá una excepción si la cadena JSON proporcionada no es válida. El uso de JsonObject.TryParse es una alternativa recomendada. Una llamada TryParse devolverá un valor booleano para indicar si se ha realizado correctamente y, si se ejecuta correctamente, jsonArray resultante.
RemoveAt(UInt32)	Quita el elemento en el índice especificado de la colección.
RemoveAtEnd()	Quita el último elemento de la matriz.
ReplaceAll(IJsonValue[])	Borra la matriz y, a continuación, inserta la colección proporcionada de objetos JsonValue como nuevos elementos de matriz.
SetAt(UInt32, IJsonValue)	Establece el valor en el índice especificado mediante jsonValue proporcionado.
Stringify()	Devuelve la representación JSON del valor encapsulado.
ToString()	Devuelve la representación JSON del valor encapsulado.
TryParse(String, JsonArray)	Analiza la cadena proporcionada en una jsonArray.

Consulte también

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