JsonObject Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.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>>, IStringable
Public NotInheritable Class JsonObject
Implements IDictionary(Of String, IJsonValue), IEnumerable(Of KeyValuePair(Of String, IJsonValue)), IStringable
- Héritage
- Attributs
- 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. |