CborReader.ReadStartMap 메서드

정의

네임스페이스:

System.Formats.Cbor

어셈블리:

System.Formats.Cbor.dll

패키지:

System.Formats.Cbor v11.0.0-preview.5.26302.115

Source:

CborReader.Map.cs

다음 데이터 항목을 맵의 시작 부분(주 형식 5)으로 읽습니다.

public:
 Nullable<int> ReadStartMap();

public int? ReadStartMap();

member this.ReadStartMap : unit -> Nullable<int>

Public Function ReadStartMap () As Nullable(Of Integer)

반품

Nullable<Int32>

특정 길이 맵의 키-값 쌍 수 또는 null 맵 길이가 무한정인 경우

예외

InvalidOperationException

다음 데이터 항목에는 올바른 주 형식이 없습니다.

CborContentException

다음 값에 잘못된 CBOR 인코딩이 있습니다.

-또는-

CBOR 인코딩 데이터가 예기치 않게 종료되었습니다.

-또는-

다음 값은 현재 규칙 모드에서 유효하지 않은 CBOR 인코딩을 사용합니다.

설명

지도 콘텐츠는 맵의 선언된 크기의 두 배 길이의 배열인 것처럼 소비됩니다. 예를 들어 형식 값이 있는 형식 Int32 의 키를 포함하는 크기 1의 String 맵은 다음에 대한 연속 호출에서 ReadInt32()ReadTextString()사용해야 합니다. 다음 값이 키인지 값인지를 추적하는 것은 호출자에게 달려 있습니다. 근본적으로 이는 CBOR이 임의 형식의 키를 허용한다는 사실에서 비롯된 기술적 제한입니다. 예를 들어 지도 자체에 맵이 있는 키가 포함될 수 있습니다.