共用方式為


Utf8JsonReader.ValueSpan 屬性

定義

如果權杖適用於單一區段,或者,如果讀取器是使用 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)

屬性值

位元組的唯讀範圍。

備註

如果在 ReadOnlySequence<位元組> 內提供 JSON,且表示權杖值的配量可融入單一區段,則 ValueSpan 包含配量值,因為它可以表示為範圍。 否則,ValueSequence 包含權杖值。

如果 HasValueSequencetrueValueSpan 則為空白。 因此,只有在 是 false 時才 HasValueSequence 存取 ValueSpan 。 否則,必須從 ValueSequence 存取權杖值。

不保證此屬性一律會包含格式正確的資料。 如果傳入 至 Utf8JsonReader 的輸入 JSON 在 JSON 字串權杖中包含不正確 UTF-8 位元組,則此屬性會傳回不正確 UTF-8 位元組。 因此,如果輸入不受信任或先前未驗證,請呼叫 GetString() 以取得 JSON 字串權杖。

由於這個屬性會傳回原始位元組,因此請避免使用它來進行文字比較。 請改為視需要呼叫 ValueTextEquals 取消逸出文字。

適用於