데이터 멤버 기본값

.NET Framework에서는 형식에 기본값의 개념을 사용합니다. 예를 들어 참조 형식의 기본값은 null이고 정수 형식의 기본값은 0입니다. 기본값으로 설정할 경우 serialize된 데이터에서 데이터 멤버를 생략하는 것이 좋을 수도 있습니다. 멤버에 기본값이 있기 때문에 실제 값을 serialize할 필요가 없으므로 성능이 향상됩니다.

serialize된 데이터에서 멤버를 생략하려면 EmitDefaultValue 특성의 DataMemberAttribute 속성을 false로 설정합니다. 기본값은 true입니다.

참고 항목

상호 운용성이나 데이터 크기 축소 등 특별히 필요한 경우에만 EmitDefaultValue 속성을 false로 설정해야 합니다.

예시

다음 코드에는 EmitDefaultValue가 false로 설정된 여러 멤버가 있습니다.

[DataContract]
public class Employee
{
    [DataMember]
    public string employeeName = null;
    [DataMember]
    public int employeeID = 0;
    [DataMember(EmitDefaultValue = false)]
    public string position = null;
    [DataMember(EmitDefaultValue = false)]
    public int salary = 0;
    [DataMember(EmitDefaultValue = false)]
    public int? bonus = null;
    [DataMember(EmitDefaultValue = false)]
    public int targetSalary = 57800;
}

<DataContract()> _
Public Class Employee
    <DataMember()> _
    Public employeeName As String = Nothing
    <DataMember()> _
    Public employeeID As Integer = 0
    <DataMember(EmitDefaultValue:=False)> _
    Public position As String = Nothing
    <DataMember(EmitDefaultValue:=False)> _
    Public salary As Integer = 0
    <DataMember(EmitDefaultValue:=False)> _
    Public Bonus As Integer = Bonus OrElse Nothing
    <DataMember(EmitDefaultValue:=False)> _
    Public targetSalary As Integer = 57800
End Class

이 클래스의 인스턴스를 serialize하면 다음과 같은 결과가 나타납니다. employeeName 및 employeeID가 serialize됩니다. employeeName 값이 null이고 employeeID 값이 0이면 명시적으로 serialize된 데이터의 일부가 됩니다. 그러나 position, salary 및 bonus 멤버는 serialize되지 않습니다. 마지막으로 57800은 정수에 대한 .NET 기본값인 0과 일치하지 않으므로 targetSalary 속성이 EmitDefaultValue로 설정되어 있더라도 false는 평소와 같이 serialize됩니다.

XML 표현

이전 예제가 XML로 serialize될 경우의 표현은 다음과 비슷합니다.

<Employee>  
   <employeeName xsi:nil="true" />  
   <employeeID>0</employeeID>  
<targetSalary>57800</targetSalary>  
</Employee>  

xsi:nil 특성은 null 값을 명시적으로 나타낼 수 있는 상호 운용 가능한 방법을 제공하는 W3C(World Wide Web Consortium) XML 스키마 인스턴스 네임스페이스의 특수 특성입니다. XML에는 지위, 급여 및 보너스 데이터 멤버에 대한 정보는 없습니다. 받는 측에서 이 값을 null, 0 및 null로 각각 해석할 수 있습니다. 타사 역직렬 변환기에서도 올바른 해석을 한다는 보장이 없으므로 이 패턴은 권장되지 않습니다. DataContractSerializer 클래스는 누락된 값에 대해 올바른 해석을 항상 선택합니다.

IsRequired와의 상호 작용

데이터 계약 버전 관리에서 설명한 것처럼 DataMemberAttribute 특성에는 IsRequired 속성이 있습니다(기본값은 false). 이 속성은 지정된 데이터 멤버가 역직렬화될 때 직렬화된 데이터에 있어야 하는지 여부를 나타냅니다. IsRequired가 true(값이 있어야 함을 표시)로 설정되고 EmitDefaultValue가 false(기본값으로 설정된 경우 값이 없어야 함을 표시)로 설정되어 있으면 결과가 모순될 수 있으므로 이 데이터 멤버의 기본값을 serialize할 수 없습니다. 그런 데이터 멤버를 기본값(일반적으로 null 또는 0)으로 설정하고 serialization을 시도하면 SerializationException가 throw됩니다.

스키마 표현

EmitDefaultValue 속성이 false로 설정된 경우 데이터 멤버의 XSD(XML 스키마 정의 언어) 스키마 표현에 대한 자세한 내용은 데이터 계약 스키마 참조에 설명되어 있습니다. 여기서는 개요만 간략하게 설명합니다.

• EmitDefaultValue가 false로 설정되면 스키마에 WCF(Windows Communication Foundation) 관련 주석으로 표시됩니다. 이 정보를 나타내는 상호 운용 가능한 방법은 없습니다. 특히 스키마의 "default" 특성은 이 용도로 사용되지 않고, minOccurs 특성은 IsRequired 설정의 영향만 받고, nillable 특성은 데이터 멤버 형식의 영향만 받습니다.

• 사용할 실제 기본값은 스키마에 표시되지 않습니다. 따라서 수신하는 엔드포인트에서 누락된 요소를 적절하게 해석해야 합니다.

스키마 가져오기에서는 앞에서 설명한 WCF 관련 주석이 발견될 때마다 EmitDefaultValue 속성이 false로 자동으로 설정됩니다. 또한 ASP.NET 웹 서비스를 사용할 때 일반적으로 발생하는 특정 상호 운용성 시나리오를 지원하기 위해 nillable 속성이 false로 설정된 참조 형식 값이 false로 설정됩니다.

참고 항목

• EmitDefaultValue
• DataMemberAttribute