Utf8JsonReader.ValueSpan プロパティ

定義

名前空間:

System.Text.Json

アセンブリ:

System.Text.Json.dll

パッケージ:

System.Text.Json v11.0.0-preview.4.26230.115

ソース:

Utf8JsonReader.cs

最後に処理されたトークンの生の値を、入力ペイロードの ReadOnlySpan<byte> スライスとして取得します。トークンが 1 つのセグメントに収まる場合、またはリーダーが ReadOnlySpan<byte> に含まれる JSON ペイロードを使用して構築された場合。

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>

バイトの読み取り専用スパン。

注釈

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

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

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

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