CborWriter.WriteStartMap(Nullable<Int32>) Yöntem

Tanım

Ad Alanı:

System.Formats.Cbor

Bütünleştirilmiş Kod:

System.Formats.Cbor.dll

Paket:

System.Formats.Cbor v8.0.0

Kaynak:

CborWriter.Map.cs

Kesin veya belirsiz uzunlukta bir haritanın başlangıcını yazar (ana tür 5).

public:
 void WriteStartMap(Nullable<int> definiteLength);

public void WriteStartMap (int? definiteLength);

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

Public Sub WriteStartMap (definiteLength As Nullable(Of Integer))

Parametreler

definiteLength

Nullable<Int32>

Kesin uzunluktaki haritanın uzunluğu veya null süresiz uzunlukta bir harita için.

Özel durumlar

ArgumentOutOfRangeException

Parametre definiteLength negatif olamaz.

InvalidOperationException

Yeni bir değer yazmak, üst veri öğesinin kesin uzunluğunu aşıyor.

-veya-

Kodlanmış değerin ana türüne üst veri öğesinde izin verilmez.

-veya-

Yazılı veriler geçerli uyumluluk modunda kabul edilmez.

Açıklamalar

Kurallı uyumluluk modlarında, bayrak etkinleştirilmediği sürece ConvertIndefiniteLengthEncodings yazıcı süresiz yazmaları reddeder. Eşleme içeriği, haritanın bildirilen boyutunun iki katı uzunlukta diziler gibi yazılır. Örneğin, dize türünde bir değere sahip bir Int32 anahtar içeren 1 boyutunda bir harita ve WriteTextString(ReadOnlySpan<Char>)için ardışık çağrılar WriteInt32(Int32) tarafından yazılmalıdır. Bir sonraki çağrının anahtar mı yoksa değer mi olduğunu izlemek arayana bağlı. Temel olarak bu, CBOR'un herhangi bir türde anahtara izin vermesinden kaynaklanan teknik bir kısıtlamadır, örneğin bir haritanın kendisi harita olan anahtarlar içerebilir.