JSON 转 C#
根据 JSON 示例为 System.Text.Json 生成 C# 类。每个属性都会添加 JsonPropertyName 特性以保留原始键名,并采用 PascalCase 命名;每个示例中都存在的键会标记为必填;可空值和可选值会使用可空类型;数组会变为 List。混合类型的值会变为 JsonElement。
常见问题
嵌套对象如何命名?
每个嵌套对象都会成为独立的 C# 类型,类型名称取自其所在键并采用 PascalCase,例如 address 会变成 Address。数组中的对象使用数组键的单数形式命名,例如 users 会变成 User。字段完全相同的对象会共用一个类型。
字段在什么情况下会是可选的?
如果数组包含多个对象,且某个键在部分对象中缺失,则该字段为可选字段:它没有 required 修饰符,类型也会变为可空类型。每个示例中都存在的键为必填键。单个对象没有可供比较的对象,因此其所有键都是必填键。
如何处理 null 值?
如果某个键在部分示例中为 null、在其他示例中有值,则该键会变为可空类型,例如 string?。如果某个键始终为 null,工具就无法据此判断其实际类型,因此会将其设为 JsonElement?;粘贴包含实际值的示例即可获得准确类型。
会使用哪些数字类型?
整数会变为 long,带小数的数字会变为 double。同时包含这两种数字的字段会变为 double。
如何处理无效名称的键?
属性名称会重新构造为 PascalCase,JsonPropertyName 特性则保留原始键名,因此 first-name 会变为 FirstName,但仍读取 first-name。若属性名称与类名相同,则会在属性名后追加数字,因为 C# 不允许两者同名。
我的 JSON 会被上传或存储吗?
JSON 仅会发送到服务器以便为此次请求生成代码,不会被存储。生成器只会读取示例的结构和值类型,因此你可以在粘贴前将敏感值替换为类型相同的占位值。