Utf8JsonReader.CopyString Methode

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Überlädt

CopyString(Span<Byte>)	Kopiert den aktuellen JSON-Tokenwert als UTF-8-Bytes aus der Quelle( ohne Scape) in einen Puffer.
CopyString(Span<Char>)	Kopiert den aktuellen JSON-Tokenwert als UTF-16-Zeichen aus der Quelle( ohne Scape) in einen Puffer.

CopyString(Span<Byte>)

Quelle:

Utf8JsonReader.TryGet.cs

Kopiert den aktuellen JSON-Tokenwert als UTF-8-Bytes aus der Quelle( ohne Scape) in einen Puffer.

public:
 int CopyString(Span<System::Byte> utf8Destination);

public readonly int CopyString (Span<byte> utf8Destination);

member this.CopyString : Span<byte> -> int

Public Function CopyString (utf8Destination As Span(Of Byte)) As Integer

Parameter

utf8Destination

Span<Byte>

Ein Puffer, in den die UTF-8-Bytes ohneScapes geschrieben werden sollen.

Gibt zurück

Int32

Die Anzahl der Bytes, die in utf8Destination geschrieben wurden.

Ausnahmen

InvalidOperationException

Das JSON-Token ist keine Zeichenfolge, d. h. es ist nicht String oder PropertyName.

- oder -

Die JSON-Zeichenfolge enthält ungültige UTF-8-Bytes oder ungültige UTF-16-Ersatzzeichen.

ArgumentException

Der Zielpuffer ist zu klein, um den Wert ohne Escapezeichen zu enthalten.

Hinweise

Im Gegensatz wird GetString()von dieser Methode nicht unterstützt Null.

Diese Methode löst eine aus ArgumentException , wenn der Zielpuffer zu klein ist, um den Wert ohne Escapezeichen zu speichern. Sie können einen Puffer mit angemessener Größe ermitteln, indem Sie die Länge von ValueSpan oder ValueSequenceabrufen, da das Ergebnis ohne Escapezeichen immer kleiner oder gleich der Länge der codierten Zeichenfolgen ist.

Weitere Informationen

• TokenType

CopyString(Span<Char>)

Quelle:

Utf8JsonReader.TryGet.cs

Kopiert den aktuellen JSON-Tokenwert als UTF-16-Zeichen aus der Quelle( ohne Scape) in einen Puffer.

public:
 int CopyString(Span<char> destination);

public readonly int CopyString (Span<char> destination);

member this.CopyString : Span<char> -> int

Public Function CopyString (destination As Span(Of Char)) As Integer

Parameter

destination

Span<Char>

Ein Puffer, in den die transcodierten UTF-16-Zeichen geschrieben werden sollen.

Gibt zurück

Int32

Die Anzahl der Zeichen, die in geschrieben werden destination.

Ausnahmen

InvalidOperationException

Das JSON-Token ist keine Zeichenfolge, d. h. es ist nicht String oder PropertyName.

- oder -

Die JSON-Zeichenfolge enthält ungültige UTF-8-Bytes oder ungültige UTF-16-Ersatzzeichen.

ArgumentException

Der Zielpuffer ist zu klein, um den Wert ohne Escapezeichen zu enthalten.

Hinweise

Im Gegensatz wird GetString()von dieser Methode nicht unterstützt Null.

Diese Methode löst eine aus ArgumentException , wenn der Zielpuffer zu klein ist, um den Wert ohne Escapezeichen zu speichern. Sie können einen Puffer mit angemessener Größe ermitteln, indem Sie die Länge von ValueSpan oder ValueSequenceabrufen, da das Ergebnis ohne Escapezeichen immer kleiner oder gleich der Länge der codierten Zeichenfolgen ist.

Weitere Informationen

• TokenType