다음을 통해 공유


Deserialization 중에 누락된 멤버 처리

기본적으로 역직렬화 중인 JSON 페이로드에 역직렬화된 POCO(Plain Old CLR Object) 유형에 없는 속성이 포함된 경우 해당 속성은 단순히 무시됩니다. .NET 8부터 모든 멤버가 페이로드에 있어야 한다는 것을 지정할 수 있습니다. 그렇지 않으면 JsonException 예외가 throw됩니다. 다음 세 가지 방법 중 하나로 이 동작을 구성할 수 있습니다.

  • POCO 유형에 [<xref:System.Text.Json.Serialization.JsonUnmappedMemberHandlingAttribute>] 특성을 추가하여 주석을 달고 누락된 멤버를 Skip하거나 Disallow하도록 지정합니다.

    [JsonUnmappedMemberHandling(JsonUnmappedMemberHandling.Disallow)]
    public class MyPoco
    {
         public int Id { get; set; }
    }
    
    JsonSerializer.Deserialize<MyPoco>("""{"Id" : 42, "AnotherId" : -1 }"""); 
    // JsonException : The JSON property 'AnotherId' could not be mapped to any .NET member contained in type 'MyPoco'.
    
  • JsonSerializerOptions.UnmappedMemberHandlingSkip 또는 Disallow로 설정합니다.

  • 관련 유형의 JsonTypeInfo 계약을 사용자 지정합니다. (계약 사용자 지정에 대한 자세한 내용은 JSON 계약 사용자 지정을 참조하세요.)