Condividi tramite


JsonObject Classe

Definizione

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à
Object Platform::Object IInspectable JsonObject
Attributi
Implementazioni

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.

Si applica a

Vedi anche