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

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

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

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