Utf8JsonReader.CopyString Método

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Sobrecargas

CopyString(Span<Byte>)	Copia o valor atual do token JSON da origem, sem escape como uma cadeia de caracteres UTF-8 para o buffer de destino.
CopyString(Span<Char>)	Copia o valor atual do token JSON da origem, sem escape e transcodificado como um buffer de caracteres UTF-16.

CopyString(Span<Byte>)

Copia o valor atual do token JSON da origem, sem escape como uma cadeia de caracteres UTF-8 para o buffer de destino.

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

Parâmetros

utf8Destination

Span<Byte>

Um buffer para gravar os bytes UTF-8 sem escape.

Retornos

Int32

O número de bytes gravados em utf8Destination.

Exceções

InvalidOperationException

O token JSON não é uma cadeia de caracteres, ou seja, não String é ou PropertyName. -ou-

A cadeia de caracteres JSON contém bytes UTF-8 inválidos ou substitutos UTF-16 inválidos.

ArgumentException

O buffer de destino é muito pequeno para manter o valor sem escape.

Comentários

Diferentemente GetString()disso, esse método não dá suporte Nulla .

Esse método será lançado ArgumentException se o buffer de destino for muito pequeno para manter o valor sem escape. Um buffer de tamanho apropriado pode ser determinado consultando o comprimento de qualquer um ValueSpan ou ValueSequence, uma vez que o resultado sem escape é sempre menor ou igual ao comprimento das cadeias de caracteres codificadas.

Confira também

• TokenType

CopyString(Span<Char>)

Copia o valor atual do token JSON da origem, sem escape e transcodificado como um buffer de caracteres UTF-16.

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

Parâmetros

destination

Span<Char>

Um buffer para gravar os caracteres UTF-16 transcodificados.

Retornos

Int32

O número de caracteres gravados em destination.

Exceções

InvalidOperationException

O token JSON não é uma cadeia de caracteres, ou seja, não String é ou PropertyName.

- ou -

A cadeia de caracteres JSON contém bytes de UTF-8 ou alternativas de UTF-16 inválidos.

ArgumentException

O buffer de destino é muito pequeno para manter o valor sem escape.

Comentários

Diferentemente GetString()disso, esse método não dá suporte Nulla .

Esse método será lançado ArgumentException se o buffer de destino for muito pequeno para manter o valor sem escape. Um buffer de tamanho apropriado pode ser determinado consultando o comprimento de qualquer um ValueSpan ou ValueSequence, uma vez que o resultado sem escape é sempre menor ou igual ao comprimento das cadeias de caracteres codificadas.

Confira também

• TokenType