XML Serialization을 제어하는 특성Attributes That Control XML Serialization

다음 표의 특성을 클래스 및 클래스 멤버에 적용하여 XmlSerializer가 클래스 인스턴스를 serialize 또는 deserialize하는 방법을 제어할 수 있습니다.You can apply the attributes in the following table to classes and class members to control the way in which the XmlSerializer serializes or deserializes an instance of the class. 이러한 특성이 XML serialization을 제어하는 방법을 이해하려면 특성을 사용하여 XML Serialization 제어를 참조하세요.To understand how these attributes control XML serialization, see Controlling XML Serialization Using Attributes.

이러한 특성을 사용하면 XML Web services를 통해 생성된 리터럴 스타일 SOAP 메시지를 제어할 수도 있습니다.These attributes can also be used to control the literal style SOAP messages generated by an XML Web service. 이러한 특성을 XML Web services 메서드에 적용하는 방법에 대한 자세한 내용은 XML Web Services의 XML serialization을 참조하세요.For more information about applying these attributes to an XML Web services method, see XML Serialization with XML Web Services.

특성에 대한 자세한 내용은 특성을 참조하세요.For more information about attributes, see Attributes.

특성Attribute 적용 대상Applies to 설명Specifies
XmlAnyAttributeAttribute XmlAttribute 개체의 배열을 반환하는 반환 값 또는 public 필드, 속성, 매개 변수입니다.Public field, property, parameter, or return value that returns an array of XmlAttribute objects. deserialize할 때 배열은 스키마에 알려지지 않은 모든 XML 특성을 나타내는 XmlAttribute 개체로 채워집니다.When deserializing, the array will be filled with XmlAttribute objects that represent all XML attributes unknown to the schema.
XmlAnyElementAttribute XmlElement 개체의 배열을 반환하는 반환 값 또는 public 필드, 속성, 매개 변수입니다.Public field, property, parameter, or return value that returns an array of XmlElement objects. deserialize할 때 배열은 스키마에 알려지지 않은 모든 XML 요소를 나타내는 XmlElement 개체로 채워집니다.When deserializing, the array is filled with XmlElement objects that represent all XML elements unknown to the schema.
XmlArrayAttribute 복잡한 개체의 배열을 반환하는 반환 값 또는 public 필드, 특성, 매개 변수입니다.Public field, property, parameter, or return value that returns an array of complex objects. 배열의 멤버는 XML 배열의 멤버로 생성됩니다.The members of the array will be generated as members of an XML array.
XmlArrayItemAttribute 복잡한 개체의 배열을 반환하는 반환 값 또는 public 필드, 특성, 매개 변수입니다.Public field, property, parameter, or return value that returns an array of complex objects. 배열에 삽입할 수 있는 파생된 형식입니다.The derived types that can be inserted into an array. 일반적으로 XmlArrayAttribute와 함께 적용됩니다.Usually applied in conjunction with an XmlArrayAttribute.
XmlAttributeAttribute public 필드, 속성, 매개 변수 또는 반환 값입니다.Public field, property, parameter, or return value. 멤버는 XML 특성으로 serialize됩니다.The member will be serialized as an XML attribute.
XmlChoiceIdentifierAttribute public 필드, 속성, 매개 변수 또는 반환 값입니다.Public field, property, parameter, or return value. 멤버는 열거형을 사용하여 명확히 할 수 있습니다.The member can be further disambiguated by using an enumeration.
XmlElementAttribute public 필드, 속성, 매개 변수 또는 반환 값입니다.Public field, property, parameter, or return value. 필드 또는 속성은 XML 요소로 serialize됩니다.The field or property will be serialized as an XML element.
XmlEnumAttribute 열거형 식별자인 public 필드입니다.Public field that is an enumeration identifier. 열거형 멤버의 요소 이름입니다.The element name of an enumeration member.
XmlIgnoreAttribute public 속성 및 필드입니다.Public properties and fields. 속성 또는 필드는 포함 클래스가 serialize될 때 무시되어야 합니다.The property or field should be ignored when the containing class is serialized.
XmlIncludeAttribute public 파생 클래스 선언 및 WSDL(웹 서비스 설명 언어) 문서에 대한 public 메서드의 반환 값입니다.Public derived class declarations, and return values of public methods for Web Services Description Language (WSDL) documents. 스키마를 생성할 때 클래스를 포함해야 합니다(serialize될 때 인식되도록).The class should be included when generating schemas (to be recognized when serialized).
XmlRootAttribute public 클래스 선언입니다.Public class declarations. 특성 대상의 XML serialization을 XML 루트 요소로 제어합니다.Controls XML serialization of the attribute target as an XML root element. 특성을 사용하여 네임스페이스와 요소 이름을 지정합니다.Use the attribute to further specify the namespace and element name.
XmlTextAttribute public 속성 및 필드입니다.Public properties and fields. 속성 또는 필드는 XML 텍스트로 serialize되어야 합니다.The property or field should be serialized as XML text.
XmlTypeAttribute public 클래스 선언입니다.Public class declarations. XML 형식의 이름 및 네임스페이스입니다.The name and namespace of the XML type.

모두 System.Xml.Serialization 네임스페이스에서 찾을 수 있는 이러한 특성 이외에 DefaultValueAttribute 특성도 필드에 적용할 수 있습니다.In addition to these attributes, which are all found in the System.Xml.Serialization namespace, you can also apply the DefaultValueAttribute attribute to a field. DefaultValueAttribute는 지정된 값이 없는 경우 멤버에 자동으로 할당될 값을 설정합니다.The DefaultValueAttribute sets the value that will be automatically assigned to the member if no value is specified.

인코드된 SOAP XML serialization을 제어하려면 인코드된 SOAP serialization을 제어하는 특성을 참조하세요.To control encoded SOAP XML serialization, see Attributes That Control Encoded SOAP Serialization.

참고자료See also