JsonObject Classe

Définition

Espace de noms:

Windows.Data.Json

Représente un objet JSON contenant une collection de paires name et JsonValue .

JsonObject est une classe activable qui implémente JsonValue et l’interface IMap<String,IJsonValue> de telle sorte que ses paires nom/valeur puissent être manipulées comme un dictionnaire. Lorsqu’il existe des valeurs avec des noms dupliqués, la paire nom/valeur est stockée.

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

Héritage

Object Platform::Object IInspectable JsonObject

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

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

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 objet à partir d’une chaîne JSON et le convertir en objet JsonObject, mettez à jour les paires nom/valeur que contient l’objet, puis sérialisez l’objet JsonObject mis à jour en tant que chaîne JSON, consultez Utilisation de JavaScript Object Notation (JSON) .

Constructeurs

JsonObject()

Initialise une nouvelle instance d’un Objet Json qui représente un objet JSON contenant une collection de paires name et JsonValue.

Propriétés

Size	Obtient la taille (nombre) de la collection.
ValueType	Obtient le type de la valeur JSON encapsulée. Les types possibles sont définis par JsonValueType.

Méthodes

Clear()	Supprime tous les éléments de la collection.
First()	Retourne l’itérateur pour l’itération sur les paires clé/valeur dans jsonObject.
GetArray()	Retourne un JsonArray si le ValueType de la valeur encapsulée est Array.
GetBoolean()	Obtient une valeur booléenne si le ValueType de la valeur encapsulée est Boolean.
GetNamedArray(String)	Obtient la valeur JsonArray avec le nom spécifié.
GetNamedArray(String, JsonArray)	Obtient la valeur JsonArray avec le nom spécifié, ou la valeur par défaut fournie si aucune valeur nommée n’est trouvée.
GetNamedBoolean(String)	Obtient la valeur booléenne avec le nom spécifié.
GetNamedBoolean(String, Boolean)	Obtient la valeur booléenne avec le nom spécifié, ou la valeur par défaut fournie si aucune valeur nommée n’est trouvée.
GetNamedNumber(String)	Obtient la valeur numérique (un double) avec le nom spécifié.
GetNamedNumber(String, Double)	Obtient la valeur numérique (un double) avec le nom spécifié, ou la valeur par défaut fournie si aucune valeur nommée de ce type n’est trouvée.
GetNamedObject(String)	Obtient la valeur JsonObject avec le nom spécifié.
GetNamedObject(String, JsonObject)	Obtient la valeur JsonObject avec le nom spécifié, ou la valeur par défaut fournie si aucune valeur nommée n’est trouvée.
GetNamedString(String)	Obtient la valeur string avec le nom spécifié.
GetNamedString(String, String)	Obtient la valeur string avec le nom spécifié, ou la valeur par défaut fournie si aucune valeur nommée de ce type n’est trouvée.
GetNamedValue(String)	Obtient la valeur JsonValue avec le nom spécifié.
GetNamedValue(String, JsonValue)	Obtient la valeur JsonValue spécifiée ou la valeur par défaut fournie si aucune valeur nommée n’est trouvée.
GetNumber()	Obtient le nombre (un double) si le ValueType de la valeur encapsulée est Number.
GetObject()	Obtient l’objet JsonObject si le ValueType de la valeur encapsulée est Object.
GetString()	Obtient la chaîne si le ValueType de la valeur encapsulée est String.
GetView()	Obtient une vue JsonObject .
HasKey(String)	Indique si l’objet JsonObject a une entrée avec la clé demandée.
Insert(String, IJsonValue)	Ajoute une nouvelle entrée à l’objet JsonObject.
Lookup(String)	Obtient la valeur JSON associée à la clé fournie, si une entrée avec cette clé existe.
Parse(String)	Analyse la chaîne JSON spécifiée qui représente un JsonObject dans une valeur JSON. Notes Cela 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, l’objet JsonObject résultant.
Remove(String)	Supprime un élément spécifique de l’objet JsonObject.
SetNamedValue(String, IJsonValue)	Définit la valeur spécifiée pour le premier objet JsonValue portant le nom spécifié. Si aucun objet de ce type n’est trouvé, un nouveau nom et une paire JsonValue sont insérés dans l’objet JSON.
Stringify()	Récupère la représentation JSON de la valeur encapsulée.
ToString()	Récupère la représentation JSON de la valeur encapsulée.
TryParse(String, JsonObject)	Analyse la chaîne spécifiée qui représente un objet JSON dans un JsonObject.

Voir aussi

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