Utf8JsonReader.ValueSequence 属性

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

仅当令牌包含在多个段内时，获取上次处理的令牌的原始值作为输入有效负载的 ReadOnlySequence<byte> 切片。

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)

属性值

ReadOnlySequence<Byte>

字节只读序列。

注解

如果在 ReadOnlySequence<byte> 内提供 JSON，并且表示令牌值的切片适合单个段，则 ValueSpan 包含切分的值，因为它可以表示为一个范围。 否则 ValueSequence 包含令牌值。

false如果是HasValueSequence，ValueSequence则为空。 因此，仅当ValueSequence访问为true时HasValueSequence。 否则，必须从 ValueSpan中访问令牌值。

不能保证此属性始终包含格式正确的数据。 如果传入的 Utf8JsonReader 输入 JSON 在 JSON 字符串令牌中包含无效的 UTF-8 字节，则此属性将按原样返回那些无效的 UTF-8 字节。 因此，如果输入不受信任或以前未验证，则调用 GetString() 以获取 JSON 字符串令牌。

由于此属性返回原始字节，因此请避免将其用于文本比较。 请改为调用 ValueTextEquals，如有必要，该调用会取消对文本的替代。