Utf8JsonReader.ValueSpan 属性

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

Source:

Utf8JsonReader.cs

如果令牌适合单个段，或者如果读取器是使用 ReadOnlySpan<byte> 中包含的 JSON 有效负载构造的，则获取上次处理的令牌的原始值作为输入有效负载的 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)

属性值

ReadOnlySpan<Byte>

字节的只读范围。

注解

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

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

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

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