JSON → C# 类型映射
字符串映射为 string 或 DateTime(符合 ISO-8601 时),整数映射为 long,带小数的数值映射为 double,布尔映射为 bool,对象会拆成专门的类,数组生成 List<T>。检测到 null 时会标记属性为可空,在启用 nullable 模式后追加 ?,而混合数组则自动降级为 List<object>,确保任何载荷都能被安全建模。
Preparing your comprehensive developer toolkit
实用指南
将 JSON 数据实时转换为强类型 C# 类,自动生成 JsonPropertyName 特性、可空引用支持以及整洁的 get/set 代码。
现代 .NET 系统需要处理 REST API、云事件、配置文件、遥测流和消息队列等大量 JSON。将样本转换为强类型 C# 类可以获得编译期检查、更友好的 IntelliSense、清晰的领域模型以及更安全的重构能力。自动化生成还能减少手写错误,借助 JsonPropertyName 保留原始键名,在跨团队协作时显著提高建模速度。
字符串映射为 string 或 DateTime(符合 ISO-8601 时),整数映射为 long,带小数的数值映射为 double,布尔映射为 bool,对象会拆成专门的类,数组生成 List<T>。检测到 null 时会标记属性为可空,在启用 nullable 模式后追加 ?,而混合数组则自动降级为 List<object>,确保任何载荷都能被安全建模。
解析器递归遍历每个对象并生成可复用的类签名,属性名统一转换为 PascalCase 并避开 C# 保留字。结构相同的对象共享同一类定义,数组重用推断出来的元素类型,避免冗余代码。转换完成后会统计类数量、属性数量以及数组数量,帮助你快速判断载荷的复杂度。
System.Text.Json 依靠 JsonPropertyName 来匹配键名,因此生成代码时可选择为每个属性保留原始 JSON 键。这样 snake_case 载荷在 C# 中也能使用 PascalCase 属性进行访问。借助 partial class,你可以在自定义文件中继续添加验证逻辑、转换器或领域注解,不会污染生成代码。
启用可空引用后,只要样本中出现 null,值类型(bool、long、double 等)和引用类型(string、List<T>、嵌套类)都会自动追加 ?。这既符合 C# 8 之后的最佳实践,又能让编译器在访问可空字段时给出提醒,显著减少运行期 NRE。
智能推断 C# 类型,生成嵌套类并保持符合 PascalCase 规范,同时保留原始 JSON 键名。
可选地为每个属性输出 JsonPropertyName,确保 snake_case 载荷在反序列化时完全匹配。
当样本中出现 null 时自动追加 ?,让可空引用安全在编译期即可被提醒。
转换完成后立即查看类、属性与数组数量,快速评估模型复杂度。
JSON 到 C# 类生成可以从 JSON 数据结构自动创建强类型 C# 类。这在处理 .NET 应用程序中的 API、配置文件或数据序列化时至关重要。生成器创建具有正确类型、可空支持和 JsonPropertyName 属性的适当 C# 类,而不是手动编写类或使用动态类型,从而节省数小时的开发时间并减少错误。
生成器将 JSON 类型映射到适当的 C# 类型:字符串变为 string 或 DateTime(对于 ISO-8601 日期),整数映射到 long,浮点数映射到 double,布尔值映射到 bool,对象变为专用类,数组变为 List<T>。空值将属性标记为可空(启用可空引用时带有 ? 后缀)。混合数组使用 List<object> 来保留异构数据。
JsonPropertyName 属性允许 C# 属性使用 PascalCase 命名(C# 约定),而 JSON 使用不同的命名(如 snake_case 或 camelCase)。该属性在序列化/反序列化期间保留原始 JSON 键名。当您的 JSON 使用非 PascalCase 键但您希望在代码中使用惯用的 C# 属性名时,请启用此选项。
可空引用类型(C# 8.0+)在引用类型可以为 null 时添加 ?,启用编译时 null 检查。启用后,当 JSON 样本包含 null 值时,生成器会在属性后附加 ?。这有助于防止 NullReferenceException 错误,使可选字段显式,并遵循现代 C# 的 null 安全最佳实践。
可以,生成器默认创建部分类(或启用时),允许您在单独的文件中扩展它们而无需修改生成的代码。您可以添加自定义方法、验证逻辑、特定领域的属性或实现接口。这种分离保持生成的代码整洁,并在 JSON 结构更改时安全地重新生成类。
微软官方的内置 JSON 序列化器文档。
了解如何使用 JsonPropertyName 修饰属性。
C# 8+ 中启用与使用 nullable reference 的官方指南。
System.Text.Json 如何处理 DateTime、DateOnly 以及时区。
了解 List<T> 及常见集合在 C# 中的使用方式。
回到工具页面,立即使用相关功能。