Freigeben über


Utf8JsonReader.CopyString Methode

Definition

Ü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
Quelle:
Utf8JsonReader.TryGet.cs
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

Die Anzahl der Bytes, die in utf8Destination geschrieben wurden.

Ausnahmen

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.

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

Gilt für:

CopyString(Span<Char>)

Quelle:
Utf8JsonReader.TryGet.cs
Quelle:
Utf8JsonReader.TryGet.cs
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

Die Anzahl der Zeichen, die in geschrieben werden destination.

Ausnahmen

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.

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

Gilt für: