Utf8JsonReader.ValueSpan 속성

정의

토큰이 단일 세그먼트에 맞거나 판독기가 ReadOnlySpan<byte>에 포함된 JSON 페이로드를 사용하여 생성된 경우 마지막으로 처리된 토큰의 원시 값을 입력 페이로드의 ReadOnlySpan<byte> 조각으로 가져옵니다.Gets the raw value of the last processed token as a ReadOnlySpan<byte> slice of the input payload, if the token fits in a single segment or if the reader was constructed with a JSON payload contained in a 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>

읽기 전용 범위(바이트)입니다.A read-only span of bytes.

설명

ReadOnlySequence<byte> 내에서 JSON을 제공하고 토큰 값을 나타내는 조각이 단일 세그먼트에 적합한 경우 ValueSpan에는 분할된 값이 포함되므로 범위로 나타낼 수 있습니다.If the JSON is provided within a ReadOnlySequence<byte> and the slice that represents the token value fits in a single segment, then ValueSpan contains the sliced value since it can be represented as a span. 그렇지 않으면 ValueSequence에는 토큰 값이 포함됩니다.Otherwise, ValueSequence contains the token value.

HasValueSequence가 이면 trueValueSpan 비어 있습니다.If HasValueSequence is true, ValueSpan is empty. 따라서 ValueSpan 가 인 경우에만 액세스할 HasValueSequencefalse 있습니다.Therefore, only access ValueSpan if HasValueSequence is false. 그렇지 않으면에서 토큰 값에 액세스 해야 합니다 ValueSequence .Otherwise, the token value must be accessed from ValueSequence.

이 속성은 항상 올바른 형식의 데이터를 포함 하는 것은 아닙니다.There is no guarantee that this property will always contain well-formed data. 에 전달 된 입력 JSON Utf8JsonReader 이 json 문자열 토큰 내에서 잘못 된 utf-8 바이트를 포함 하는 경우이 속성은 잘못 된 utf-8 바이트를 그대로 반환 합니다.If the input JSON passed in to the Utf8JsonReader contains invalid UTF-8 bytes within JSON string tokens, this property will return back those invalid UTF-8 bytes as is. 따라서 입력이 신뢰 되지 않거나 이전에 유효성이 검사 되지 않은 경우를 호출 GetString() 하 여 JSON 문자열 토큰을 가져옵니다.Therefore, if the input is untrusted or not previously validated, call GetString() to get the JSON string token.

이 속성은 원시 바이트를 반환 하므로 텍스트 비교에 사용 하지 마십시오.Since this property returns the raw bytes, avoid using it for text comparison. ValueTextEquals필요한 경우 텍스트를 unescapes 하는를 대신 호출 합니다.Instead call ValueTextEquals which unescapes the text if necessary.

적용 대상