JsonArray Klasse

Definition

Namespace:

Windows.Data.Json

Stellt ein JSON-Array dar.

JsonArray erbt die Schnittstellen IVector(IJsonValue) und IIterable(IJsonValue), die Methoden zum Durchlaufen der Elemente im Array und zum Aktualisieren des Inhalts bereitstellen.

public ref class JsonArray sealed : IIterable<IJsonValue ^>, IVector<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 JsonArray final : IIterable<IJsonValue>, IVector<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 JsonArray : IEnumerable<IJsonValue>, IList<IJsonValue>, IStringable

Public NotInheritable Class JsonArray
Implements IEnumerable(Of IJsonValue), IList(Of IJsonValue), IStringable

Vererbung

Object Platform::Object IInspectable JsonArray

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IIterable<T> IEnumerable<T> IIterable<IJsonValue> IEnumerable<IJsonValue> IVector<IJsonValue> IList<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 Array aus einer JSON-Zeichenfolge zu analysieren und in ein JsonArray-Objekt zu konvertieren, die Werte zu aktualisieren, die das Array enthält, und dann das aktualisierte JsonArray-Objekt als JSON-Zeichenfolge zu serialisieren, finden Sie unter Using JavaScript Object Notation (JSON).

Auflisten der Sammlung in C# oder Microsoft Visual Basic

Ein JsonArray ist aufzählbar, sodass Sie sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der Auflistung aufzulisten. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<IJsonValue> umgewandelt werden. Wenn Sie explizit umwandeln müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer IJsonValue-Einschränkung in IEnumerable<T> um.

Konstruktoren

JsonArray()

Erstellt ein neues JsonArray-Objekt , das ein JSON-Array darstellt.

Eigenschaften

Size	Ruft die Größe (Anzahl) des Arrays ab.
ValueType	Ruft den Typ der Werte innerhalb des Arrays ab. Mögliche Typen werden von JsonValueType definiert.

Methoden

Append(IJsonValue)	Fügt dem Array ein neues Element hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung.
First()	Gibt den Iterator für die Iteration über die Elemente im Array zurück.
GetArray()	Ruft das JsonArray ab , wenn der ValueType des gekapselten Werts Array ist.
GetArrayAt(UInt32)	Ruft das JsonArray am angegebenen Index ab, wenn der ValueType des gekapselten Werts Array ist.
GetAt(UInt32)	Gibt das Element zurück, das sich am angegebenen Index befindet.
GetBoolean()	Ruft den booleschen Wert ab, wenn der ValueType des gekapselten Werts Boolean ist.
GetBooleanAt(UInt32)	Ruft den booleschen Wert am angegebenen Index ab, wenn valueType des Werts in diesem Index boolean ist.
GetMany(UInt32, IJsonValue[])	Ruft alle Arrayelemente vom Typ IJsonValue ab, beginnend mit einem angegebenen Index.
GetNumber()	Ruft die Zahl (double) ab, wenn der ValueType des gekapselten Werts Number ist.
GetNumberAt(UInt32)	Ruft die Zahl (ein Double) am angegebenen Index ab, wenn valueType des Werts an diesem Index Number ist.
GetObject()	Ruft das JsonObject ab , wenn der ValueType des gekapselten Werts Object ist.
GetObjectAt(UInt32)	Ruft das JsonObject am angegebenen Index ab, wenn der ValueType des gekapselten Werts Object ist.
GetString()	Ruft die Zeichenfolge ab, wenn der ValueType des gekapselten Werts String ist.
GetStringAt(UInt32)	Ruft die Zeichenfolge am angegebenen Index ab, wenn der ValueType des gekapselten Werts String ist.
GetView()	Ruft eine JsonArray-Ansicht ab.
IndexOf(IJsonValue, UInt32)	Sucht nach einem JsonValue-Objekt und gibt den nullbasierten Index des ersten Vorkommens im JsonArray zurück.
InsertAt(UInt32, IJsonValue)	Fügt einen JsonValue-Wert am angegebenen Index in ein Array ein.
Parse(String)	Analysiert die angegebene JSON-Zeichenfolge, die ein JsonArray darstellt. 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 auf Erfolg oder Fehler hinweist, und bei erfolgreicher Ausführung das resultierende JsonArray.
RemoveAt(UInt32)	Entfernt das Element am angegebenen Index der Auflistung.
RemoveAtEnd()	Entfernt das letzte Element im Array.
ReplaceAll(IJsonValue[])	Löscht das Array und fügt dann die bereitgestellte Auflistung von JsonValue-Objekten als neue Arrayelemente ein.
SetAt(UInt32, IJsonValue)	Legt den Wert am angegebenen Index mithilfe des bereitgestellten JsonValue fest.
Stringify()	Gibt die JSON-Darstellung des gekapselten Werts zurück.
ToString()	Gibt die JSON-Darstellung des gekapselten Werts zurück.
TryParse(String, JsonArray)	Analysiert die bereitgestellte Zeichenfolge in ein JsonArray.

Weitere Informationen

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