Utf8JsonReader.ValueSpan プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
トークンが 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)プロパティ値
バイト型の読み取り専用スパン。
注釈
JSON が ReadOnlySequence<byte> 内に指定されていて、トークン値を表すスライスが単一のセグメント内に収まる場合、ValueSpan にはスライスされた値が格納されます。それをスパンとして表現できるからです。 それ以外の場合、ValueSequence にはトークン値が格納されます。
の場合HasValueSequenceは ValueSpan true空です。 したがって、次の場合HasValueSequenceにのみアクセスValueSpanしますfalse。
それ以外の場合は、トークン値にアクセス ValueSequenceする必要があります。
このプロパティに常に整形式のデータが含まれるという保証はありません。 渡された Utf8JsonReader 入力 JSON に JSON 文字列トークン内に無効な UTF-8 バイトが含まれている場合、このプロパティは無効な UTF-8 バイトをそのまま返します。
したがって、入力が信頼されていない場合、または以前に検証されていない場合は、JSON 文字列トークンを取得する呼び出しを呼び出 GetString() します。
このプロパティは生のバイトを返すので、テキスト比較には使用しないでください。 代わりに、必要に応じてテキストをエスケープ解除するテキストを呼び出 ValueTextEquals します。