CborWriter.WriteStartMap(Nullable<Int32>) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee schrijft u het begin van een definitieve of onbepaalde lengtekaart (hoofdtype 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))Parameters
De lengte van de kaart met bepaalde lengte of null voor een kaart met onbepaalde lengte.
Uitzonderingen
De definiteLength parameter kan niet negatief zijn.
Het schrijven van een nieuwe waarde overschrijdt de definitieve lengte van het bovenliggende gegevensitem.
– of –
Het belangrijkste type van de gecodeerde waarde is niet toegestaan in het bovenliggende gegevensitem.
– of –
De geschreven gegevens worden niet geaccepteerd in de huidige conformantiemodus.
Opmerkingen
In canonieke conformancemodi weigert de schrijver schrijfbewerkingen voor onbepaalde tijd, tenzij de ConvertIndefiniteLengthEncodings vlag is ingeschakeld. De inhoud van de kaart wordt geschreven alsof matrices tweemaal de lengte van de gedeclareerde grootte van de kaart hebben. Een kaart van grootte 1 met een sleutel van het type Int32 met een waarde van het type tekenreeks moet bijvoorbeeld worden geschreven door opeenvolgende aanroepen naar WriteInt32(Int32) en WriteTextString(ReadOnlySpan<Char>). Het is aan de beller om bij te houden of de volgende aanroep een sleutel of een waarde is. Dit is een technische beperking die voortvloeit uit het feit dat CBOR sleutels van elk type toestaat, bijvoorbeeld een kaart kan sleutels bevatten die zelf kaarten zijn.
