Utf8JsonReader.ValueSequence プロパティ

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)

プロパティ値

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

注釈

JSON が ReadOnlySequence<byte> 内で提供され、トークン値を表すスライスが 1 つのセグメントに収まる場合、 ValueSpan にはスライスされた値が含まれます。これはスパンとして表すことができるためです。 それ以外の場合、 ValueSequence にはトークン値が含まれます。

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

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

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