CborReader.ReadStartMap Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest das nächste Datenelement als Anfang einer Zuordnung (Haupttyp 5).
public:
Nullable<int> ReadStartMap();
public int? ReadStartMap ();
member this.ReadStartMap : unit -> Nullable<int>
Public Function ReadStartMap () As Nullable(Of Integer)
Gibt zurück
Die Anzahl der Schlüssel-Wert-Paare in einer Zuordnung mit bestimmter Länge oder null
, wenn die Länge der Zuordnung unbestimmt ist.
Ausnahmen
Das nächste Datenelement verfügt nicht über den richtigen Haupttyp.
Der nächste Wert weist eine ungültige CBOR-Codierung auf.
- oder -
Es ist ein unerwartetes Ende der CBOR-Codierungsdaten aufgetreten.
- oder -
Der nächste Wert verwendet eine CBOR-Codierung, die im aktuellen Konformitätsmodus nicht gültig ist.
Hinweise
Karteninhalte werden so genutzt, als ob es sich um Arrays handelte, die doppelt so lang sind wie die deklarierte Größe der Karte. Für instance muss eine Zuordnung der Größe 1, die einen Schlüssel vom Typ Int32 mit einem Wert vom Typ String enthält, von aufeinander folgenden Aufrufen ReadInt32() von und ReadTextString()verwendet werden. Es liegt an dem Aufrufer, nachzuverfolgen, ob der nächste Wert ein Schlüssel oder ein Wert ist. Grundsätzlich ist dies eine technische Einschränkung, die sich aus der Tatsache ergibt, dass CBOR Schlüssel beliebiger Art zulässt, für instance eine Karte Schlüssel enthalten kann, die selbst Karten sind.