CborReader.ReadStartMap Metoda

Definice

Obor názvů:

System.Formats.Cbor

Sestavení:

System.Formats.Cbor.dll

Balíček:

System.Formats.Cbor v8.0.0

Zdroj:

CborReader.Map.cs

Přečte další datovou položku jako začátek mapy (hlavní typ 5).

public:
 Nullable<int> ReadStartMap();

public int? ReadStartMap ();

member this.ReadStartMap : unit -> Nullable<int>

Public Function ReadStartMap () As Nullable(Of Integer)

Návraty

Nullable<Int32>

Počet párů klíč-hodnota v mapě s určitou délkou nebo null pokud je mapa neurčitá.

Výjimky

InvalidOperationException

Další položka dat nemá správný hlavní typ.

CborContentException

Další hodnota má neplatné kódování CBOR.

-nebo-

Došlo k neočekávanému ukončení dat kódování CBOR.

-nebo-

Další hodnota používá kódování CBOR, které není platné v aktuálním režimu shody.

Poznámky

Obsah mapy se spotřebovává, jako by šlo o pole, která jsou dvakrát větší, než je deklarovaná velikost mapy. Například mapa velikosti 1 obsahující klíč typu Int32 s hodnotou typu String musí být využita následnými voláními a ReadInt32()ReadTextString(). Je na volajícím, aby sledoval, jestli je další hodnota klíč nebo hodnota. 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.