Utf8JsonReader.ValueSpan 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
토큰이 단일 세그먼트에 맞거나 ReadOnlySpan<바이트에> 포함된 JSON 페이로드를 사용하여 판독기를 생성한 경우 마지막으로 처리된 토큰의 원시 값을 입력 페이로드의 ReadOnlySpan<바이트> 조각으로 가져옵니다.
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<바이트> 내에 제공되고 토큰 값을 나타내는 조각이 단일 세그먼트 ValueSpan 에 맞는 경우 범위로 표시될 수 있으므로 조각화된 값을 포함합니다. 그렇지 않으면 ValueSequence 토큰 값을 포함합니다.
이true면 HasValueSequence 비어 ValueSpan 있습니다.
따라서 인 경우에만 HasValueSequence 액세스 ValueSpan 합니다false.
그렇지 않으면 토큰 값에 액세스 ValueSequence해야 합니다.
이 속성에 항상 올바른 형식의 데이터가 포함된다는 보장은 없습니다. JSON 문자열 토큰 내에서 잘못된 UTF-8 바이트를 포함하는 입력 JSON에 전달 Utf8JsonReader 된 경우 이 속성은 잘못된 UTF-8 바이트를 있는 그대로 반환합니다.
따라서 입력이 신뢰할 수 없거나 이전에 유효성이 검사되지 않은 경우 JSON 문자열 토큰을 가져오도록 호출 GetString() 합니다.
이 속성은 원시 바이트를 반환하므로 텍스트 비교에 사용하지 마십시오. 필요한 경우 텍스트의 비스케이프를 호출 ValueTextEquals 합니다.
