Utf8JsonReader.ValueSpan 속성

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

토큰이 단일 세그먼트에 맞거나 판독기가 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>

읽기 전용 범위(바이트)입니다.

설명

ReadOnlySequence<byte> 내에서 JSON을 제공하고 토큰 값을 나타내는 조각이 단일 세그먼트에 적합한 경우 ValueSpan에는 분할된 값이 포함되므로 범위로 나타낼 수 있습니다. 그렇지 않으면 ValueSequence에는 토큰 값이 포함됩니다.

이 true``ValueSpan 면 HasValueSequence 비어 있습니다. 따라서 인 경우에만 HasValueSequence 액세스 ValueSpan 합니다false. 그렇지 않으면 토큰 값에 액세스 ValueSequence해야 합니다.

이 속성에 항상 올바른 형식의 데이터가 포함된다는 보장은 없습니다. JSON 문자열 토큰 내에서 잘못된 UTF-8 바이트를 포함하는 입력 JSON Utf8JsonReader 이 있는 경우 이 속성은 잘못된 UTF-8 바이트를 있는 그대로 반환합니다. 따라서 입력이 신뢰할 수 없거나 이전에 유효성이 검사되지 않은 경우 JSON 문자열 토큰을 가져오도록 호출 GetString() 합니다.

이 속성은 원시 바이트를 반환하므로 텍스트 비교에 사용하지 마십시오. 대신 필요한 경우 텍스트를 비스케이프 해제하는 호출을 실행 ValueTextEquals 합니다.