Freigeben über


JsonValue Klasse

Definition

Implementiert die IJsonValue-Schnittstelle , die einen JSON-Wert darstellt.

Ein JsonValue-Objekt kann die drei primitiven JSON-Werttypen Boolean, Number und String darstellen und auch die komplexen Werttypen von Array und Object darstellen, indem es Möglichkeiten zum Zugriff auf diese Werte bereitstellt.

public ref class JsonValue sealed : 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)]
class JsonValue final : 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)]
public sealed class JsonValue : IJsonValue, IStringable
Public NotInheritable Class JsonValue
Implements IJsonValue, IStringable
Vererbung
Object Platform::Object IInspectable JsonValue
Attribute
Implementiert

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 JsonValue-Objekt verfügt über überladene Konstruktoren zum Instanziieren eines neuen Objekts aus einem JSON-String-, Number- oder booleschen Wert und einem Standardkonstruktor, der ein JsonValue-Objekt mit einem ValueType-Wert von NULL instanziiert.

Ein Beispiel dafür, wie diese Klassenmethoden verwendet werden, um eine Zahl oder Zeichenfolge aus einer JSON-Zeichenfolge zu analysieren und in ein JsonValue-Objekt zu konvertieren, finden Sie unter Using JavaScript Object Notation (JSON).

Eigenschaften

ValueType

Ruft den Typ des gekapselten JSON-Werts ab. Mögliche Typen werden durch JsonValueType definiert.

Methoden

CreateBooleanValue(Boolean)

Erstellt einen JsonValue-Wert aus einem booleschen Wert.

CreateNullValue()

Erstellt einen JsonValue-Wert mit einem NULL-Wert .

CreateNumberValue(Double)

Erstellt einen JsonValue aus einer Zahl (Double).

CreateStringValue(String)

Erstellt die Zeichenfolge für ein JsonValue-Objekt.

GetArray()

Ruft ein Array ab, wenn der ValueType des gekapselten Werts Array ist.

GetBoolean()

Ruft den Booleschen Wert ab, wenn valueType des gekapselten Werts boolean ist.

GetNumber()

Ruft die Zahl (double) ab, wenn der ValueType des gekapselten Werts Number ist.

GetObject()

Ruft ein JsonObject ab, wenn der ValueType des gekapselten Werts Object ist.

GetString()

Ruft eine Zeichenfolge ab, wenn der ValueType des gekapselten Werts String ist.

Parse(String)

Analysiert die angegebene JSON-Zeichenfolge in einen JsonValue-Wert.

Hinweis

Diese Methode löst eine Ausnahme aus, 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 den resultierenden JsonValue-Wert angibt.

Stringify()

Ruft die JSON-Darstellung des gekapselten Werts ab.

ToString()

Ruft die JSON-Darstellung des gekapselten Werts ab.

TryParse(String, JsonValue)

Analysiert die angegebene Zeichenfolge in jsonValue.

Gilt für:

Weitere Informationen