Utf8JsonReader.ValueSequence プロパティ

定義

名前空間:

System.Text.Json

アセンブリ:

System.Text.Json.dll

パッケージ:

System.Text.Json v9.0.0-preview.3.24172.9

ソース:

Utf8JsonReader.cs

トークンが複数のセグメントに含まれている場合にのみ、最後に処理されたトークンの生の値を入力ペイロードの 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>

バイト読み取り専用シーケンス。

注釈

JSON が ReadOnlySequence<byte> 内に指定されていて、トークン値を表すスライスが単一のセグメント内に収まる場合、ValueSpan にはスライスされた値が格納されます。それをスパンとして表現できるからです。 それ以外の場合、ValueSequence にはトークン値が格納されます。

が のfalseValueSequence場合HasValueSequence、 は空です。 したがって、 が trueの場合HasValueSequenceにのみアクセスValueSequenceします。 それ以外の場合は、 から ValueSpanトークン値にアクセスする必要があります。

このプロパティに常に整形式のデータが含まれるという保証はありません。 に Utf8JsonReader 渡された入力 JSON に JSON 文字列トークン内に無効な UTF-8 バイトが含まれている場合、このプロパティは無効な UTF-8 バイトをそのまま返します。 したがって、入力が信頼されていないか、以前に検証されていない場合は、 を呼び出 GetString() して JSON 文字列トークンを取得します。

このプロパティは生バイトを返すので、テキスト比較には使用しないでください。 代わりに を呼び出 ValueTextEqualsします。これにより、必要に応じてテキストがエスケープ解除されます。