CborWriter.WriteStartMap(Nullable<Int32>) Metoda

Definice

Obor názvů:

System.Formats.Cbor

Sestavení:

System.Formats.Cbor.dll

Balíček:

System.Formats.Cbor v8.0.0

Zdroj:

CborWriter.Map.cs

Zapíše začátek mapy s určitou nebo neomezenou délkou (hlavní typ 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))

Parametry

definiteLength

Nullable<Int32>

Délka mapy s určitou délkou nebo null pro mapu s neomezenou délkou.

Výjimky

ArgumentOutOfRangeException

Parametr definiteLength nemůže být záporný.

InvalidOperationException

Zápis nové hodnoty překračuje určitou délku nadřazené datové položky.

-nebo-

Hlavní typ zakódované hodnoty není v nadřazené položce dat povolený.

-nebo-

Zapsaná data nejsou v aktuálním režimu shody přijata.

Poznámky

V režimech kanonické shody zapisovač odmítne zápisy na neomezenou délku ConvertIndefiniteLengthEncodings , pokud není povolený příznak. Obsah mapy se zapisuje jako pole, která odpovídají dvojnásobku délky deklarované velikosti mapy. Například mapa velikosti 1 obsahující klíč typu Int32 s hodnotou řetězce typu musí být zapsána následnými voláními WriteInt32(Int32) a WriteTextString(ReadOnlySpan<Char>). Je na volajícím, aby sledoval, jestli je další hovor klíčem nebo hodnotou. V podstatě se jedná o technické omezení vyplývající ze skutečnosti, že CBOR umožňuje klíče libovolného typu, například mapa může obsahovat klíče, které jsou samotné mapy.