DataMemberAttribute.EmitDefaultValue 속성

정의

네임스페이스:

System.Runtime.Serialization

어셈블리:

System.Runtime.Serialization.Primitives.dll

어셈블리:

System.Runtime.Serialization.dll

어셈블리:

netstandard.dll

serialize할 필드나 속성에 대한 기본값을 serialize하는지 여부를 지정하는 값을 가져오거나 설정합니다.

public:
 property bool EmitDefaultValue { bool get(); void set(bool value); };

public bool EmitDefaultValue { get; set; }

member this.EmitDefaultValue : bool with get, set

Public Property EmitDefaultValue As Boolean

속성 값

Boolean

멤버의 기본값을 serialization 스트림에서 생성해야 하면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다.

예제

다음 예제에서는 다양한 필드에 설정된 false 속성을 보여줍니다EmitDefaultValue.

[DataContract]
public class Employee
{
    // The CLR default for as string is a null value.
    // This will be written as <employeeName xsi:nill="true" />
    [DataMember]
    public string EmployeeName = null;

    // This will be written as <employeeID>0</employeeID>
    [DataMember]
    public int employeeID = 0;

    // The next three will not be written because the EmitDefaultValue = false.
    [DataMember(EmitDefaultValue = false)]
    public string position = null;
    [DataMember(EmitDefaultValue = false)]
    public int salary = 0;
    [DataMember(EmitDefaultValue = false)]
    public int? bonus = null;

    // This will be written as <targetSalary>57800</targetSalary>
    [DataMember(EmitDefaultValue = false)]
    public int targetSalary = 57800;
}

<DataContract()>  _
Public Class Employee
    ' The CLR default for as string is a null value.
    ' This will be written as <employeeName xsi:nil="true" />
    <DataMember()>  _
    Public employeeName As String = Nothing
    
    ' This will be written as <employeeID>0</employeeID>
    <DataMember()>  _
    Public employeeID As Integer = 0
    
    ' The next two will not be written because the EmitDefaultValue = false.
    <DataMember(EmitDefaultValue := False)> Public position As String = Nothing
    <DataMember(EmitDefaultValue := False)> Public salary As Integer = 0

    ' This will be written as <targetSalary>555</targetSalary> because 
    ' the 555 does not match the .NET default of 0.
    <DataMember(EmitDefaultValue := False)> Public targetSalary As Integer = 555
End Class

설명

.NET Framework에서는 형식에 기본값의 개념을 사용합니다. 예를 들어 참조 형식의 경우 기본값은 0이고 null정수 형식의 경우 0입니다. 경우에 따라 기본값으로 설정된 경우 직렬화된 데이터에서 데이터 멤버를 생략하는 것이 좋습니다. 이렇게 하려면 속성을 false (true기본적으로)로 설정합니다EmitDefaultValue.

참고

속성을 설정해도 EmitDefaultValue false 권장되는 방법은 아닙니다. 상호 운용성 또는 데이터 크기 줄이기와 같은 특정 요구 사항이 있는 경우에만 수행해야 합니다.