Utf8JsonReader.ValueSequence 속성

정의

네임스페이스:

System.Text.Json

어셈블리:

System.Text.Json.dll

토큰이 여러 세그먼트에 포함된 경우에만 마지막 처리된 토큰의 원시 값을 입력 페이로드의 ReadOnlySequence<byte> 조각으로 가져옵니다.

public:
 property System::Buffers::ReadOnlySequence<System::Byte> ValueSequence { System::Buffers::ReadOnlySequence<System::Byte> get(); };

public System.Buffers.ReadOnlySequence<byte> ValueSequence { get; }

member this.ValueSequence : System.Buffers.ReadOnlySequence<byte>

Public ReadOnly Property ValueSequence As ReadOnlySequence(Of Byte)

속성 값

ReadOnlySequence<Byte>

바이트 읽기 전용 시퀀스입니다.

설명

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

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

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

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