Utf8JsonReader.ValueSequence Propriedade

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Obtém o valor bruto do último token processado como uma fatia de ReadOnlySequence<byte> do conteúdo de entrada, somente se o token estiver contido em vários segmentos.

public:
 property System::Buffers::ReadOnlySequence<System::Byte> ValueSequence { System::Buffers::ReadOnlySequence<System::Byte> get(); };

public System.Buffers.ReadOnlySequence<byte> ValueSequence { get; }

member this.ValueSequence : System.Buffers.ReadOnlySequence<byte>

Public ReadOnly Property ValueSequence As ReadOnlySequence(Of Byte)

Valor da propriedade

ReadOnlySequence<Byte>

Uma sequência somente leitura de bytes.

Comentários

Se o JSON é fornecido em um ReadOnlySequence<byte> e a fatia que representa o valor do token se encaixa em um único segmento, ValueSpan contém o valor fatiado, pois pode ser representado como um intervalo. Caso contrário, ValueSequence contém o valor do token.

Se HasValueSequence for false, ValueSequence está vazio. Portanto, só acessará ValueSequence se HasValueSequence for true. Caso contrário, o valor do token deve ser acessado de ValueSpan.

Não há garantia de que essa propriedade sempre conterá dados bem formados. Se o JSON de entrada passado para os Utf8JsonReader bytes UTF-8 inválidos dentro de tokens de cadeia de caracteres JSON, essa propriedade retornará os bytes UTF-8 inválidos como está. Portanto, se a entrada não for confiável ou não for validada anteriormente, chame GetString() para obter o token de cadeia de caracteres JSON.

Como essa propriedade retorna os bytes brutos, evite usá-la para comparação de texto. Em vez disso, chame ValueTextEquals, o que desescaliza o texto, se necessário.