JSONからC#へ
JSONのサンプルから、System.Text.Json用のC#クラスを生成します。各プロパティには元のキーを指定するJsonPropertyName属性が付き、名前はPascalCaseになります。すべてのサンプルにあるキーは必須としてマークされ、省略可能な値とnull許容値にはnull許容型が使われます。配列はListになります。型が混在する値はJsonElementになります。
よくある質問
ネストされたオブジェクトにはどのような名前が付けられますか?
ネストされた各オブジェクトは、それを保持するキーをもとにPascalCaseで命名された独自のC#型になります。そのため、addressはAddressになります。配列内のオブジェクトには、配列キーの単数形が使われるため、usersはUserになります。フィールドが完全に同じオブジェクトは、同じ型を共有します。
フィールドがオプションになるのはどのような場合ですか?
配列に複数のオブジェクトがあり、一部のオブジェクトでキーが欠けている場合、そのフィールドは省略可能です。required修飾子は付かず、型はnull許容になります。すべてのサンプルに存在するキーは必須です。単一のオブジェクトには比較対象がないため、そのすべてのキーが必須になります。
null値はどのように扱われますか?
一部のサンプルでnull、ほかのサンプルで値が設定されているキーは、string?のようなnull許容型になります。常にnullのキーでは実際の型を判別できないため、JsonElement?になります。正確な型を得るには、実際の値を含むサンプルを貼り付けてください。
どの数値型が使われますか?
整数はlong、小数を含む数値はdoubleになります。両方の値を持つフィールドはdoubleになります。
有効な名前ではないキーはどうなりますか?
プロパティ名はPascalCaseに再構成され、JsonPropertyName属性で元のキーが保持されます。そのため、first-nameはFirstNameになり、引き続きfirst-nameとして読み取られます。クラス名と同じになるプロパティには番号が追加されます。C#ではクラス名と同じプロパティ名を使えないためです。
JSONはアップロードまたは保存されますか?
JSONはこのリクエストのコード生成にのみ使用するためサーバーに送信され、保存されません。ジェネレーターが読み取るのはサンプルの構造と値の型だけなので、貼り付ける前に、機密性の高い値を同じ型のプレースホルダーに置き換えることができます。