JSON 源生成 API 重构

JSON 源生成器的输出调用的 API 已重构。 重构使它们在未来更容易使用新功能进行扩展。 在 .NET 6 RC 2 运行时上运行时，显式使用 JSON 源生成器并使用 .NET 6 RC 1 或更早版本编译的项目将因运行时异常而失败。

旧行为

使用 .NET 6 RC 1 或更早版本的 System.Text.Json 源生成器和库编译的项目按预期运行。

新行为

针对 .NET 6 RC 2 运行时，使用 .NET 6 RC 1 版本的 System.Text.Json 源生成器和库编译的项目运行时会失败。 使用 RC 2 SDK 重新编译的项目按预期工作。

引入的版本

6.0 RC 2

中断性变更的类型

此项更改可能会影响二进制兼容性。

更改原因

引入此更改是为了更轻松地在将来使用功能扩展源生成器实现。 有关详细信息，请参阅 dotnet/runtime#59243。

建议的操作

使用 RC 2 SDK 重新编译应用。

受影响的 API

• System.Text.Json.Serialization.JsonSerializerContext
• System.Text.Json.Serialization.JsonSerializableAttribute
• System.Text.Json.Serialization.JsonSourceGenerationOptionsAttribute
• System.Text.Json.Serialization.Metadata（不适合直接使用）

另请参阅

• 如何在 System.Text.Json 中使用源生成