CborReader.ReadStartMap 方法

定義

命名空間:

System.Formats.Cbor

組件:

System.Formats.Cbor.dll

套件:

System.Formats.Cbor v8.0.0

來源:

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 的索引鍵，必須由 和ReadTextString()的後續呼叫ReadInt32()取用。 呼叫端必須追蹤下一個值是索引鍵還是值。 基本上，這是一項技術限制，其源自 CBOR 允許任意類型的索引鍵，例如地圖可以包含對應本身的索引鍵。