Utf8JsonReader.CopyString Metodo

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Pacchetto:

System.Text.Json v9.0.0-preview.3.24172.9

Overload

CopyString(Span<Byte>)	Copia il valore del token JSON corrente dall'origine, senza caratteri di escape, come byte UTF-8 in un buffer.
CopyString(Span<Char>)	Copia il valore del token JSON corrente dall'origine, senza caratteri di escape, come caratteri UTF-16 in un buffer.

CopyString(Span<Byte>)

Origine:

Utf8JsonReader.TryGet.cs

Copia il valore del token JSON corrente dall'origine, senza caratteri di escape, come byte UTF-8 in un buffer.

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

Parametri

utf8Destination

Span<Byte>

Buffer in cui scrivere i byte UTF-8 senza caratteri di escape.

Restituisce

Int32

Numero di byte scritti in utf8Destination.

Eccezioni

InvalidOperationException

Il token JSON non è una stringa, ovvero non String è o PropertyName.

-oppure-

La stringa JSON contiene byte UTF-8 non validi o surrogati UTF-16 non validi.

ArgumentException

Il buffer di destinazione è troppo piccolo per contenere il valore senza caratteri di escape.

Commenti

A differenza di GetString(), questo metodo non supporta Null.

Questo metodo genererà un'eccezione ArgumentException se il buffer di destinazione è troppo piccolo per contenere il valore senza caratteri di escape. È possibile determinare un buffer con dimensioni appropriate consultando la lunghezza di ValueSpan o ValueSequence, poiché il risultato senza caratteri di escape è sempre minore o uguale alla lunghezza delle stringhe codificate.

Vedi anche

• TokenType

CopyString(Span<Char>)

Origine:

Utf8JsonReader.TryGet.cs

Copia il valore del token JSON corrente dall'origine, senza caratteri di escape, come caratteri UTF-16 in un buffer.

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

Parametri

destination

Span<Char>

Buffer in cui scrivere i caratteri UTF-16 transcodificati.

Restituisce

Int32

Numero di caratteri scritti in destination.

Eccezioni

InvalidOperationException

Il token JSON non è una stringa, ovvero non String è o PropertyName.

-oppure-

La stringa JSON contiene byte UTF-8 non validi o surrogati UTF-16 non validi.

ArgumentException

Il buffer di destinazione è troppo piccolo per contenere il valore senza caratteri di escape.

Commenti

A differenza di GetString(), questo metodo non supporta Null.

Questo metodo genererà un'eccezione ArgumentException se il buffer di destinazione è troppo piccolo per contenere il valore senza caratteri di escape. È possibile determinare un buffer con dimensioni appropriate consultando la lunghezza di ValueSpan o ValueSequence, poiché il risultato senza caratteri di escape è sempre minore o uguale alla lunghezza delle stringhe codificate.

Vedi anche

• TokenType