CborWriter.WriteStartMap(Nullable<Int32>) メソッド

定義

名前空間:

System.Formats.Cbor

アセンブリ:

System.Formats.Cbor.dll

確定または不確定の長さのマップ (メジャー型 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))

パラメーター

definiteLength

Nullable<Int32>

確定長のマップの長さ。または不確定長のマップの場合は null。

例外

ArgumentOutOfRangeException

definiteLength パラメーターを負にすることはできません。

InvalidOperationException

新しい値を書き込むと、親データ項目の確定長を超えます。

または

エンコードされた値のメジャー型は、親データ項目では許可されていません。

または

書き込まれたデータは、現在の準拠モードでは受け入れられません。

注釈

標準準拠モードでは、フラグが有効になっていない限り ConvertIndefiniteLengthEncodings 、ライターは無期限の書き込みを拒否します。 マップの内容は、配列がマップの宣言されたサイズの 2 倍の長さであるかのように書き込まれます。 たとえば、文字列型の値を持つ型Int32のキーを含むサイズ 1 のマップは、and に対する連続する呼び出しWriteInt32(Int32)WriteTextString(ReadOnlySpan<Char>)によって書き込む必要があります。 次の呼び出しがキーか値かを追跡するのは、呼び出し元次第です。 基本的に、これは、CBOR が任意の型のキーを許可するという事実に起因する技術的な制限です。たとえば、マップにはマップ自体であるキーを含めることができます。