JsonArray Classe

Définition

Espace de noms:

Windows.Data.Json

Représente un tableau JSON.

JsonArray hérite des interfaces IVector(IJsonValue) et IIterable(IJsonValue), qui fournissent des méthodes permettant d’itérer à travers les éléments du tableau et de mettre à jour son contenu.

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

Héritage

Object Platform::Object IInspectable JsonArray

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IIterable<T> IEnumerable<T> IIterable<IJsonValue> IEnumerable<IJsonValue> IVector<IJsonValue> IList<IJsonValue> IJsonValue IStringable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Pour obtenir un exemple de la façon dont ces méthodes de classe sont utilisées pour analyser un tableau à partir d’une chaîne JSON et le convertir en objet JsonArray, mettez à jour les valeurs que contient le tableau, puis sérialisez l’objet JsonArray mis à jour en tant que chaîne JSON, consultez Utilisation de JavaScript Object Notation (JSON) .

Énumération de la collection en C# ou Microsoft Visual Basic

Un JsonArray étant énumérable, vous pouvez utiliser une syntaxe spécifique au langage, telle que foreach en C# pour énumérer les éléments de la collection. Le compilateur effectue le casting de type pour vous et vous n’aurez pas besoin de caster IEnumerable<IJsonValue> explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast en IEnumerable<T> avec une contrainte IJsonValue .

Constructeurs

JsonArray()

Crée un objet JsonArray qui représente un tableau JSON.

Propriétés

Size	Obtient la taille (nombre) du tableau.
ValueType	Obtient le type des valeurs dans le tableau. Les types possibles sont définis par JsonValueType.

Méthodes

Append(IJsonValue)	Ajoute un nouvel élément au tableau.
Clear()	Supprime tous les éléments de la collection.
First()	Retourne l’itérateur pour l’itération sur les éléments du tableau.
GetArray()	Obtient le JsonArray si le ValueType de la valeur encapsulée est Array.
GetArrayAt(UInt32)	Obtient le JsonArray à l’index spécifié si le ValueType de la valeur encapsulée est Array .
GetAt(UInt32)	Retourne l’élément situé à l’index spécifié.
GetBoolean()	Obtient la valeur booléenne si la valeur ValueType de la valeur encapsulée est Boolean.
GetBooleanAt(UInt32)	Obtient la valeur booléenne à l’index spécifié si le ValueType de la valeur à cet index est Boolean.
GetMany(UInt32, IJsonValue[])	Obtient tous les éléments de tableau de type IJsonValue, à partir d’un index spécifié.
GetNumber()	Obtient le nombre (un Double) si le ValueType de la valeur encapsulée est Number.
GetNumberAt(UInt32)	Obtient le nombre (un double) à l’index spécifié si le ValueType de la valeur à cet index est Number.
GetObject()	Obtient l’objet JsonObject si le ValueType de la valeur encapsulée est Object.
GetObjectAt(UInt32)	Obtient l’objet JsonObject à l’index spécifié si le ValueType de la valeur encapsulée est Object.
GetString()	Obtient la valeur String si le ValueType de la valeur encapsulée est String.
GetStringAt(UInt32)	Obtient la chaîne à l’index spécifié si le ValueType de la valeur encapsulée est String.
GetView()	Obtient une vue JsonArray .
IndexOf(IJsonValue, UInt32)	Recherche un objet JsonValue et retourne l’index de base zéro de sa première occurrence dans jsonArray.
InsertAt(UInt32, IJsonValue)	Insère une valeur JsonValue dans un tableau à l’index spécifié.
Parse(String)	Analyse la chaîne JSON spécifiée qui représente un JsonArray. Notes Cette méthode lève une exception si la chaîne JSON fournie n’est pas valide. L’utilisation de JsonObject.TryParse est une alternative recommandée. Un appel TryParse retourne une valeur booléenne pour indiquer la réussite ou l’échec et, en cas de réussite, le JsonArray résultant.
RemoveAt(UInt32)	Supprime l'élément au niveau de l'index spécifié de la collection.
RemoveAtEnd()	Supprime le dernier élément du tableau.
ReplaceAll(IJsonValue[])	Efface le tableau, puis insère la collection d’objets JsonValue fournie en tant que nouveaux éléments de tableau.
SetAt(UInt32, IJsonValue)	Définit la valeur à l’index spécifié à l’aide de la valeur JsonValue fournie.
Stringify()	Retourne la représentation JSON de la valeur encapsulée.
ToString()	Retourne la représentation JSON de la valeur encapsulée.
TryParse(String, JsonArray)	Analyse la chaîne fournie dans un JsonArray.

Voir aussi

• Utilisation de JavaScript Object Notation (JSON)
• Exemple JSON (Windows 10)