CborReader.ReadStartMap 方法

定义

命名空间:

System.Formats.Cbor

程序集:

System.Formats.Cbor.dll

包:

System.Formats.Cbor v8.0.0

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 编码。

注解

使用地图内容时，就像是数组一样，长度是地图声明大小的两倍。 例如，大小 1 的映射必须通过对 和 的Int32连续调用ReadInt32()来使用包含 类型的键类型的StringReadTextString()值。 由调用方来跟踪下一个值是键还是值。 从根本上讲，这是一个技术限制，源于 CBOR 允许任意类型的密钥，例如映射可以包含映射本身的键。