CborWriter.WriteStartMap(Nullable<Int32>) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skriver början på en bestämd eller obegränsad karta (huvudtyp 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))Parametrar
Längden på kartan med bestämd längd eller null för en karta med obestämd längd.
Undantag
Parametern definiteLength får inte vara negativ.
Om du skriver ett nytt värde överskrids den slutgiltiga längden på det överordnade dataobjektet.
-eller-
Huvudtypen för det kodade värdet tillåts inte i det överordnade dataobjektet.
-eller-
De skriftliga data accepteras inte i det aktuella överensstämmelseläget.
Kommentarer
I kanoniska överensstämmelselägen avvisar skrivaren skrivningar med obestämd längd om inte ConvertIndefiniteLengthEncodings flaggan är aktiverad. Kartinnehåll skrivs som om matriser är dubbelt så långa som kartans deklarerade storlek. Till exempel måste en karta med storlek 1 som innehåller en nyckel av typen Int32 med ett värde av typen sträng skrivas av efterföljande anrop till WriteInt32(Int32) och WriteTextString(ReadOnlySpan<Char>). Det är upp till anroparen att hålla reda på om nästa anrop är en nyckel eller ett värde. I grund och botten är detta en teknisk begränsning som härrör från det faktum att CBOR tillåter nycklar av alla typer, till exempel kan en karta innehålla nycklar som är kartor själva.
