語言

CborWriter.WriteStartMap(Nullable<Int32>) 方法

定義

寫出確定或不定長度映射的起始(大類型5)。

public:
 void WriteStartMap(Nullable<int> definiteLength);
public void WriteStartMap(int? definiteLength);
member this.WriteStartMap : Nullable<int> -> unit
Public Sub WriteStartMap (definiteLength As Nullable(Of Integer))

參數

definiteLength
Nullable<Int32>

定長度映射的長度,或 null 不定長度映射的長度。

例外狀況

參數 definiteLength 不能為負。

寫入新值會超過父資料項目的確定長度。

-或-

編碼值的主要類型在父資料項目中不被允許。

-或-

目前的符合模式下不接受書面資料。

備註

在典範相容模式下,寫入者會拒絕無限長度的寫入,除非 ConvertIndefiniteLengthEncodings 該標誌已啟用。 映射內容以陣列形式寫成是映射宣告大小兩倍長度的陣列。 例如,一個大小為 1、包含型別 Int32 為 的鍵值為 的映射,必須透過連續呼叫 和 WriteInt32(Int32)WriteTextString(ReadOnlySpan<Char>)來寫入。 呼叫者需自行判斷下一通呼叫是鍵還是值。 根本上,這是一個技術限制,源自於 CBOR 允許任何類型的金鑰,例如,一個映射可以包含本身即映射的金鑰。

適用於