다음을 통해 공유

역직렬화에 사용되지 않는 비공용 매개 변수가 없는 생성자

  • 아티클

지원되는 모든 TFM(대상 프레임워크 모니커) 간의 일관성을 위해 비공용 매개 변수가 없는 생성자는 기본적으로 JsonSerializer를 사용한 역직렬화에 더 이상 사용되지 않습니다.

변경 내용 설명

.NET Standard 2.0 이상, 즉 버전 4.6.0-4.7.2를 지원하는 독립 실행형 System.Text.Json NuGet 패키지는 .NET Core 3.0 및 3.1의 기본 제공 동작과 일관되지 않게 작동합니다. .NET Core 3.x에서는 내부 및 프라이빗 생성자를 역직렬화에 사용할 수 있습니다. 독립형 패키지에서 비공용 생성자는 허용되지 않으며 비공용 매개 변수가 없는 생성자가 정의되지 않은 경우 MissingMethodException이 throw됩니다.

.NET 5 및 System.Text.Json NuGet 패키지 5.0.0부터 NuGet 패키지와 기본 제공 API 간에 동작이 일관됩니다. 매개 변수가 없는 생성자를 비롯한 비공용 생성자는 기본적으로 직렬 변환기에서 무시됩니다. 직렬 변환기는 역직렬화를 위해 다음 생성자 중 하나를 사용합니다.

  • JsonConstructorAttribute 주석이 달린 공용 생성자.
  • 공용 매개 변수가 없는 생성자.
  • 공용 매개 변수가 있는 생성자(공용 생성자만 있는 경우)

이러한 생성자를 사용할 수 없는 경우 유형을 역직렬화하려고 하면 NotSupportedException이 throw됩니다.

도입된 버전

5.0

변경 이유

  • .NET Core 3.0 이상 버전 및 .NET Standard 2.0에 대해 System.Text.Json이 빌드하는 모든 TFM(대상 프레임워크 모니커) 간에 일관된 동작을 적용하려면
  • JsonSerializer는 생성자, 속성 또는 필드에 관계없이 유형의 비공용 노출 영역을 호출하지 않아야 하기 때문입니다.
  • 유형을 소유하고 있으며 적합한 경우 매개 변수가 없는 생성자를 공용으로 설정합니다.
  • 그렇지 않으면 형식에 대해 JsonConverter<T>를 구현하고 역직렬화 동작을 제어합니다. 해당 시나리오에 대한 C# 접근성 규칙에서 허용하는 경우 JsonConverter<T> 구현에서 public이 아닌 생성자를 호출할 수 있습니다.

영향을 받는 API