Utf8JsonReader.ValueSequence Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.