CborWriter.WriteStartMap(Nullable<Int32>) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
寫出確定或不定長度映射的起始(大類型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 不能為負。
備註
在典範相容模式下,寫入者會拒絕無限長度的寫入,除非 ConvertIndefiniteLengthEncodings 該標誌已啟用。 映射內容以陣列形式寫成是映射宣告大小兩倍長度的陣列。 例如,一個大小為 1、包含型別 Int32 為 的鍵值為 的映射,必須透過連續呼叫 和 WriteInt32(Int32)WriteTextString(ReadOnlySpan<Char>)來寫入。 呼叫者需自行判斷下一通呼叫是鍵還是值。 根本上,這是一個技術限制,源自於 CBOR 允許任何類型的金鑰,例如,一個映射可以包含本身即映射的金鑰。