Utf8JsonReader.ValueSpan 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 ReadOnlySpan<byte> do conteúdo de entrada, se o token couber em um único segmento ou se o leitor foi construído com um conteúdo JSON contido em um ReadOnlySpan<byte>.

public:
 property ReadOnlySpan<System::Byte> ValueSpan { ReadOnlySpan<System::Byte> get(); };

public ReadOnlySpan<byte> ValueSpan { get; }

member this.ValueSpan : ReadOnlySpan<byte>

Public ReadOnly Property ValueSpan As ReadOnlySpan(Of Byte)

Valor da propriedade

ReadOnlySpan<Byte>

Uma extensão de 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 true, ValueSpan está vazio. Portanto, só acessará ValueSpan se HasValueSequence for false. Caso contrário, o valor do token deve ser acessado de ValueSequence.

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.