Freigeben über

Utf8JsonWriter.WriteStartArray Methode

  • Referenz

Definition

Namespace:
System.Text.Json
Assembly:
System.Text.Json.dll

Überlädt

WriteStartArray()

Schreibt den Anfang eines JSON-Arrays.
WriteStartArray(ReadOnlySpan<Byte>)

Schreibt den Anfang eines JSON-Arrays mit einem als schreibgeschützte Spanne von Bytes angegebenen Eigenschaftennamen als Schlüssel.
WriteStartArray(ReadOnlySpan<Char>)

Schreibt den Anfang eines JSON-Arrays mit einem als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen als Schlüssel.
WriteStartArray(String)

Schreibt den Anfang eines JSON-Arrays mit einem als Zeichenfolge angegebenen Eigenschaftennamen als Schlüssel.
WriteStartArray(JsonEncodedText)

Schreibt den Anfang eines JSON-Arrays mit einem vorcodierten Eigenschaftennamen als Schlüssel.

WriteStartArray()

Schreibt den Anfang eines JSON-Arrays.

public:
 void WriteStartArray();
public void WriteStartArray ();
member this.WriteStartArray : unit -> unit
Public Sub WriteStartArray ()

Ausnahmen

InvalidOperationException

Die Tiefe des JSON-Codes überschreitet die maximale Tiefe 1.000.

- oder -

Validierung ist aktiviert, und dieser Schreibvorgang würde ungültige JSON-Daten produzieren.

Gilt für

WriteStartArray(ReadOnlySpan<Byte>)

Schreibt den Anfang eines JSON-Arrays mit einem als schreibgeschützte Spanne von Bytes angegebenen Eigenschaftennamen als Schlüssel.

public:
 void WriteStartArray(ReadOnlySpan<System::Byte> utf8PropertyName);
public void WriteStartArray (ReadOnlySpan<byte> utf8PropertyName);
member this.WriteStartArray : ReadOnlySpan<byte> -> unit
Public Sub WriteStartArray (utf8PropertyName As ReadOnlySpan(Of Byte))

Parameter

utf8PropertyName
ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Arrays.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

Die Tiefe des JSON-Codes überschreitet die maximale Tiefe 1.000.

- oder -

Validierung ist aktiviert, und dieser Schreibvorgang würde ungültige JSON-Daten produzieren.

Hinweise

Der Eigenschaftsname wird vor dem Schreiben escapet.

Gilt für

WriteStartArray(ReadOnlySpan<Char>)

Schreibt den Anfang eines JSON-Arrays mit einem als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen als Schlüssel.

public:
 void WriteStartArray(ReadOnlySpan<char> propertyName);
public void WriteStartArray (ReadOnlySpan<char> propertyName);
member this.WriteStartArray : ReadOnlySpan<char> -> unit
Public Sub WriteStartArray (propertyName As ReadOnlySpan(Of Char))

Parameter

propertyName
ReadOnlySpan<Char>

Der UTF-16-codierte Eigenschaftenname des JSON-Arrays, das zu transcodieren und als UTF-8 zu schreiben ist.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

Die Tiefe des JSON-Codes überschreitet die maximale Tiefe 1.000.

- oder -

Validierung ist aktiviert, und dieser Schreibvorgang würde ungültige JSON-Daten produzieren.

Hinweise

Der Eigenschaftsname wird vor dem Schreiben escapet.

Gilt für

WriteStartArray(String)

Schreibt den Anfang eines JSON-Arrays mit einem als Zeichenfolge angegebenen Eigenschaftennamen als Schlüssel.

public:
 void WriteStartArray(System::String ^ propertyName);
public void WriteStartArray (string propertyName);
member this.WriteStartArray : string -> unit
Public Sub WriteStartArray (propertyName As String)

Parameter

propertyName
String

Der UTF-16-codierte Eigenschaftenname des JSON-Arrays, das zu transcodieren und als UTF-8 zu schreiben ist.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

Die Tiefe des JSON-Codes überschreitet die maximale Tiefe 1.000.

- oder -

Validierung ist aktiviert, und dieser Schreibvorgang würde ungültige JSON-Daten produzieren.

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

Der Eigenschaftsname wird vor dem Schreiben escapet.

Gilt für

WriteStartArray(JsonEncodedText)

Schreibt den Anfang eines JSON-Arrays mit einem vorcodierten Eigenschaftennamen als Schlüssel.

public:
 void WriteStartArray(System::Text::Json::JsonEncodedText propertyName);
public void WriteStartArray (System.Text.Json.JsonEncodedText propertyName);
member this.WriteStartArray : System.Text.Json.JsonEncodedText -> unit
Public Sub WriteStartArray (propertyName As JsonEncodedText)

Parameter

propertyName
JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Arrays, das zu transcodieren und als UTF-8 zu schreiben ist.

Ausnahmen

InvalidOperationException

Die Tiefe des JSON-Codes hat die maximale Tiefe 1.000 überschritten.

- oder -

Validierung ist aktiviert, und diese Methode würde im Schreiben ungültiger JSON-Daten resultieren.

Hinweise

Der Eigenschaftsname sollte bereits beim Erstellen der Instanz JsonEncodedText escapet werden.

Gilt für