JsonObject Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un oggetto JSON contenente una raccolta di coppie name e JsonValue .
JsonObject è una classe activatable che implementa JsonValue e l'interfaccia IMap<String,IJsonValue> , in modo che le coppie nome/valore possano essere modificate come un dizionario. Quando sono presenti valori con nomi duplicati, verrà archiviata l'ultima coppia nome/valore.
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
- Ereditarietà
- Attributi
- Implementazioni
-
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
Requisiti Windows
Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Commenti
Per un esempio di come questi metodi di classe vengono usati per analizzare un oggetto da una stringa JSON e convertirlo in un oggetto JsonObject, aggiornare le coppie nome/valore che l'oggetto contiene e quindi serializzare l'oggetto JsonObject aggiornato come stringa JSON, vedere Uso di JavaScript Object Notation (JSON) .
Costruttori
JsonObject() |
Inizializza una nuova istanza di jsonObject che rappresenta un oggetto JSON contenente una raccolta di coppie nome e JsonValue . |
Proprietà
Size |
Ottiene le dimensioni (conteggio) dell'insieme. |
ValueType |
Ottiene il tipo del valore JSON incapsulato. I tipi possibili sono definiti da JsonValueType. |
Metodi
Clear() |
Rimuove tutti gli elementi dalla raccolta. |
First() |
Restituisce l'iteratore per l'iterazione sulle coppie chiave/valore in JsonObject. |
GetArray() |
Restituisce un oggetto JsonArray se il valore ValueType del valore incapsulato è Array. |
GetBoolean() |
Ottiene un valore booleano se valueType del valore incapsulato è Boolean. |
GetNamedArray(String) |
Ottiene il valore JsonArray con il nome specificato. |
GetNamedArray(String, JsonArray) |
Ottiene il valore JsonArray con il nome specificato o il valore predefinito specificato se non viene trovato alcun valore denominato. |
GetNamedBoolean(String) |
Ottiene il valore booleano con il nome specificato. |
GetNamedBoolean(String, Boolean) |
Ottiene il valore booleano con il nome specificato o il valore predefinito specificato se non viene trovato alcun valore denominato. |
GetNamedNumber(String) |
Ottiene il valore del numero ( double) con il nome specificato. |
GetNamedNumber(String, Double) |
Ottiene il valore numerico ( double) con il nome specificato o il valore predefinito specificato se non viene trovato alcun valore denominato. |
GetNamedObject(String) |
Ottiene il valore JsonObject con il nome specificato. |
GetNamedObject(String, JsonObject) |
Ottiene il valore JsonObject con il nome specificato o il valore predefinito specificato se non viene trovato alcun valore denominato. |
GetNamedString(String) |
Ottiene il valore String con il nome specificato. |
GetNamedString(String, String) |
Ottiene il valore String con il nome specificato o il valore predefinito specificato se non viene trovato alcun valore denominato. |
GetNamedValue(String) |
Ottiene il valore JsonValue con il nome specificato. |
GetNamedValue(String, JsonValue) |
Ottiene il valore JsonValue specificato o il valore predefinito specificato se non viene trovato alcun valore denominato. |
GetNumber() |
Ottiene il numero ( un valore Double) se valueType del valore incapsulato è Number. |
GetObject() |
Ottiene jsonObject se il valore ValueType del valore incapsulato è Object. |
GetString() |
Ottiene il valore String se valueType del valore incapsulato è String. |
GetView() |
Ottiene una visualizzazione JsonObject . |
HasKey(String) |
Indica se jsonObject ha una voce con la chiave richiesta. |
Insert(String, IJsonValue) |
Aggiunge una nuova voce a JsonObject. |
Lookup(String) |
Ottiene il valore JSON associato alla chiave specificata, se esiste una voce con tale chiave. |
Parse(String) |
Analizza la stringa JSON specificata che rappresenta un oggetto JsonObject in un valore JSON. Nota Verrà generata un'eccezione se la stringa JSON specificata non è valida. L'uso di JsonObject.TryParse è un'alternativa consigliata. Una chiamata TryParse restituirà un valore booleano per indicare l'esito positivo o negativo e, se ha esito positivo, l'oggetto JsonObject risultante. |
Remove(String) |
Rimuove un elemento specifico da JsonObject. |
SetNamedValue(String, IJsonValue) |
Imposta il valore del primo oggetto JsonValue con il nome specificato sul valore specificato. Se non viene trovato alcun oggetto di questo tipo, viene inserito un nuovo nome e una coppia JsonValue nell'oggetto JSON. |
Stringify() |
Recupera la rappresentazione JSON del valore incapsulato. |
ToString() |
Recupera la rappresentazione JSON del valore incapsulato. |
TryParse(String, JsonObject) |
Analizza la stringa specificata che rappresenta un oggetto JSON in un oggetto JsonObject. |