Utf8JsonReader.ValueSpan 屬性

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

套件:

System.Text.Json v9.0.0-rc.2.24473.5

來源:

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<位元組> 內提供 JSON，且表示權杖值的配量可融入單一區段，則 ValueSpan 包含配量值，因為它可以表示為範圍。 否則，ValueSequence 包含權杖值。

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

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

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