Utf8JsonReader.ValueSpan プロパティ

定義

名前空間:

System.Text.Json

アセンブリ:

System.Text.Json.dll

トークンが 1 つのセグメントに収まる場合、またはリーダーが 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>

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

注釈

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

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

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

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