Utf8JsonReader.ValueSequence 속성

정의

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

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)

속성 값

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

설명

JSON이 ReadOnlySequence<바이트> 내에 제공되고 토큰 값을 나타내는 조각이 단일 세그먼트 ValueSpan 에 맞는 경우 범위로 표시될 수 있으므로 조각화된 값을 포함합니다. 그렇지 않으면 ValueSequence 토큰 값을 포함합니다.

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

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

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

적용 대상