Utf8JsonReader.CopyString Método

Definição

Namespace:
System.Text.Json
Assembly:
System.Text.Json.dll
Pacote:
System.Text.Json v11.0.0-preview.4.26230.115

Sobrecargas

Nome Description
CopyString(Span<Byte>)

Copia o valor do token JSON atual da origem, sem escape, como bytes UTF-8 para um buffer.
CopyString(Span<Char>)

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

CopyString(Span<Byte>)

Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs

Copia o valor do token JSON atual da origem, sem escape, como bytes UTF-8 para um 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

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

Ao contrário GetString(), esse método não dá suporte Nulla .

Esse método gerará um ArgumentException se o buffer de destino for muito pequeno para manter o valor não escamoso. Você pode determinar um buffer de tamanho adequado consultando o comprimento de 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

Aplica-se a

CopyString(Span<Char>)

Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs
Origem:
Utf8JsonReader.TryGet.cs

Copia o valor do token JSON atual da origem, sem escape, como caracteres UTF-16 para um 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

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 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

Ao contrário GetString(), esse método não dá suporte Nulla .

Esse método gerará um ArgumentException se o buffer de destino for muito pequeno para manter o valor não escamoso. Você pode determinar um buffer de tamanho adequado consultando o comprimento de 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

Aplica-se a