JsonObject Klasse

Definition

Namespace:

Windows.Data.Json

Stellt ein JSON-Objekt dar, das eine Auflistung von Name- und JsonValue-Paaren enthält.

JsonObject ist eine aktivierbare Klasse, die JsonValue und die IMap<String,IJsonValue-Schnittstelle> implementiert, sodass ihre Name-Wert-Paare wie ein Wörterbuch bearbeitet werden können. Wenn Werte mit doppelten Namen vorhanden sind, wird das Nachnamen-Wert-Paar gespeichert.

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

Vererbung

Object Platform::Object IInspectable JsonObject

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

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

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Ein Beispiel dafür, wie diese Klassenmethoden verwendet werden, um ein Objekt aus einer JSON-Zeichenfolge zu analysieren und in ein JsonObject-Objekt zu konvertieren, die Namen-Wert-Paare zu aktualisieren, die das Objekt enthält, und dann das aktualisierte JsonObject-Objekt als JSON-Zeichenfolge zu serialisieren, finden Sie unter Using JavaScript Object Notation (JSON).

Konstruktoren

JsonObject()

Initialisiert eine neue instance eines JsonObject-Objekts, das ein JSON-Objekt darstellt, das eine Auflistung von Name- und JsonValue-Paaren enthält.

Eigenschaften

Size	Ruft die Größe (Anzahl) der Auflistung ab.
ValueType	Ruft den Typ des gekapselten JSON-Werts ab. Mögliche Typen werden durch JsonValueType definiert.

Methoden

Clear()	Entfernt alle Elemente aus der Auflistung.
First()	Gibt den Iterator für die Iteration über die Schlüssel-Wert-Paare im JsonObject zurück.
GetArray()	Gibt ein JsonArray zurück, wenn der ValueType des gekapselten Werts Array ist.
GetBoolean()	Ruft einen Booleschen Wert ab, wenn valueType des gekapselten Werts boolean ist.
GetNamedArray(String)	Ruft den JsonArray-Wert mit dem angegebenen Namen ab.
GetNamedArray(String, JsonArray)	Ruft den JsonArray-Wert mit dem angegebenen Namen oder den angegebenen Standardwert ab, wenn kein solcher benannter Wert gefunden wird.
GetNamedBoolean(String)	Ruft den booleschen Wert mit dem angegebenen Namen ab.
GetNamedBoolean(String, Boolean)	Ruft den booleschen Wert mit dem angegebenen Namen oder den angegebenen Standardwert ab, wenn kein solcher benannter Wert gefunden wird.
GetNamedNumber(String)	Ruft den Zahlenwert (double) mit dem angegebenen Namen ab.
GetNamedNumber(String, Double)	Ruft den Zahlenwert (double) mit dem angegebenen Namen oder den angegebenen Standardwert ab, wenn kein solcher benannter Wert gefunden wird.
GetNamedObject(String)	Ruft den JsonObject-Wert mit dem angegebenen Namen ab.
GetNamedObject(String, JsonObject)	Ruft den JsonObject-Wert mit dem angegebenen Namen oder den angegebenen Standardwert ab, wenn kein solcher benannter Wert gefunden wird.
GetNamedString(String)	Ruft den String-Wert mit dem angegebenen Namen ab.
GetNamedString(String, String)	Ruft den String-Wert mit dem angegebenen Namen oder den angegebenen Standardwert ab, wenn kein solcher benannter Wert gefunden wird.
GetNamedValue(String)	Ruft den JsonValue-Wert mit dem angegebenen Namen ab.
GetNamedValue(String, JsonValue)	Ruft den angegebenen JsonValue-Wert oder den angegebenen Standardwert ab, wenn kein solcher benannter Wert gefunden wird.
GetNumber()	Ruft die Zahl (double) ab, wenn der ValueType des gekapselten Werts Number ist.
GetObject()	Ruft das JsonObject ab, wenn der ValueType des gekapselten Werts Object ist.
GetString()	Ruft die Zeichenfolge ab, wenn der ValueType des gekapselten Werts String ist.
GetView()	Ruft eine JsonObject-Ansicht ab.
HasKey(String)	Gibt an, ob das JsonObject über einen Eintrag mit dem angeforderten Schlüssel verfügt.
Insert(String, IJsonValue)	Fügt dem JsonObject einen neuen Eintrag hinzu.
Lookup(String)	Ruft den JSON-Wert ab, der dem angegebenen Schlüssel zugeordnet ist, wenn ein Eintrag mit diesem Schlüssel vorhanden ist.
Parse(String)	Analysiert die angegebene JSON-Zeichenfolge, die ein JsonObject darstellt, in einen JSON-Wert. Hinweis Dadurch wird eine Ausnahme ausgelöst, wenn die bereitgestellte JSON-Zeichenfolge ungültig ist. Die Verwendung von JsonObject.TryParse ist eine empfohlene Alternative. Ein TryParse-Aufruf gibt einen booleschen Wert zurück, der den Erfolg oder Fehler und bei Erfolgreicher Ausführung das resultierende JsonObject-Objekt angibt.
Remove(String)	Entfernt ein bestimmtes Element aus dem JsonObject.
SetNamedValue(String, IJsonValue)	Legt den Wert des ersten JsonValue-Objekts mit dem angegebenen Namen auf den angegebenen Wert fest. Wenn kein solches Objekt gefunden wird, wird ein neuer Name und ein JsonValue-Paar in das JSON-Objekt eingefügt.
Stringify()	Ruft die JSON-Darstellung des gekapselten Werts ab.
ToString()	Ruft die JSON-Darstellung des gekapselten Werts ab.
TryParse(String, JsonObject)	Analysiert die angegebene Zeichenfolge, die ein JSON-Objekt darstellt, in ein JsonObject.

Weitere Informationen

• Verwenden der JavaScript-Objektnotation (JSON)
• JSON-Beispiel (Windows 10)