Utf8JsonReader.CopyString Método

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Sobrecargas

CopyString(Span<Byte>)	Copia el valor del token JSON actual del origen, sin escape, como bytes UTF-8 en un búfer.
CopyString(Span<Char>)	Copia el valor del token JSON actual del origen, sin escape, como caracteres UTF-16 en un búfer.

CopyString(Span<Byte>)

Source:

Utf8JsonReader.TryGet.cs

Copia el valor del token JSON actual del origen, sin escape, como bytes UTF-8 en un búfer.

C#

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

Parámetros

utf8Destination

Span<Byte>

Búfer en el que se van a escribir los bytes UTF-8 sin escape.

Devoluciones

Int32

Número de bytes escritos en utf8Destination.

Excepciones

InvalidOperationException

El token JSON no es una cadena, es decir, no String es o PropertyName.

o bien

La cadena JSON contiene bytes UTF-8 no válidos o suplentes UTF-16 no válidos.

ArgumentException

El búfer de destino es demasiado pequeño para contener el valor sin escape.

Comentarios

A diferencia GetString()de , este método no admite Null.

Este método producirá un ArgumentException si el búfer de destino es demasiado pequeño para contener el valor sin escape. Puede determinar un búfer de tamaño adecuado consultando la longitud de o ValueSpanValueSequence, ya que el resultado sin escape siempre es menor o igual que la longitud de las cadenas codificadas.

Consulte también

• TokenType

CopyString(Span<Char>)

Source:

Utf8JsonReader.TryGet.cs

Copia el valor del token JSON actual del origen, sin escape, como caracteres UTF-16 en un búfer.

C#

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

Parámetros

destination

Span<Char>

Búfer en el que se van a escribir los caracteres UTF-16 transcodificados.

Devoluciones

Int32

Número de caracteres escritos en destination.

Excepciones

InvalidOperationException

El token JSON no es una cadena, es decir, no String es o PropertyName.

o bien

La cadena JSON contiene bytes UTF-8 no válidos o suplentes UTF-16 no válidos.

ArgumentException

El búfer de destino es demasiado pequeño para contener el valor sin escape.

Comentarios

A diferencia GetString()de , este método no admite Null.

Este método producirá un ArgumentException si el búfer de destino es demasiado pequeño para contener el valor sin escape. Puede determinar un búfer de tamaño adecuado consultando la longitud de o ValueSpanValueSequence, ya que el resultado sin escape siempre es menor o igual que la longitud de las cadenas codificadas.

Consulte también

• TokenType