CborReader.ReadStartMap 方法

定義

命名空間:

System.Formats.Cbor

組件:

System.Formats.Cbor.dll

套件:

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

來源:

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 為 且值為 的 String 鍵的映射，必須被連續呼叫 ReadInt32() 和 ReadTextString()消耗。 呼叫者需自行判斷下一個值是鍵值還是值。 根本上，這是技術上的限制，源自 CBOR 允許任意類型的鍵，例如一個映射可以包含本身即映射的鍵。