CborWriter.WriteStartMap(Nullable<Int32>) 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.
Schreibt den Anfang einer Zuordnung mit bestimmter oder unbestimmter Länge (Haupttyp 5).
public:
void WriteStartMap(Nullable<int> definiteLength);public void WriteStartMap (int? definiteLength);member this.WriteStartMap : Nullable<int> -> unitPublic Sub WriteStartMap (definiteLength As Nullable(Of Integer))Parameter
Die Länge der Zuordnung mit bestimmter Länge oder null für eine Zuordnung mit unbestimmter Länge.
Ausnahmen
Der definiteLength-Parameter darf nicht negativ sein.
Das Schreiben eines neuen Werts überschreitet die bestimmte Länge des übergeordneten Datenelements.
- oder -
Der Haupttyp des codierten Werts ist im übergeordneten Datenelement nicht zulässig.
- oder -
Die geschriebenen Daten werden im aktuellen Konformitätsmodus nicht akzeptiert.
Hinweise
In kanonischen Konformitätsmodi wird der Writer unbestimmte Schreibvorgänge ablehnen, es sei denn, das ConvertIndefiniteLengthEncodings Flag ist aktiviert. Karteninhalte werden so geschrieben, als ob Arrays zweimal die Länge der deklarierten Größe der Karte aufweisen. Beispielsweise muss eine Zuordnung von Größe 1, die einen Schlüssel des Typs Int32 mit einem Wert der Typzeichenfolge enthält, durch aufeinander folgende Aufrufe WriteInt32(Int32) und WriteTextString(ReadOnlySpan<Char>). Der Anrufer kann nachverfolgen, ob es sich bei dem nächsten Anruf um einen Schlüssel oder einen Wert handelt. Grundsätzlich ist dies eine technische Einschränkung, die von der Tatsache stammt, dass CBOR Schlüssel eines beliebigen Typs ermöglicht, z. B. kann eine Karte Schlüssel enthalten, die sich selbst zugeordnet sind.