인코딩된 SOAP Serialization을 제어하는 특성Attributes That Control Encoded SOAP Serialization

World Wide Web 컨소시엄(W3C) 문서 SOAP(Simple Object Access Protocol) 1.1에는 SOAP 매개 변수를 인코딩할 수 있는 방법을 설명하는 선택적 단원(5단원)이 포함되어 있습니다.The World Wide Web Consortium (W3C) document named Simple Object Access Protocol (SOAP) 1.1 contains an optional section (section 5) that describes how SOAP parameters can be encoded. 사양의 5단원을 따르려면 System.Xml.Serialization 네임스페이스에 속한 특별한 특성 집합을 사용해야 합니다.To conform to section 5 of the specification, you must use a special set of attributes found in the System.Xml.Serialization namespace. 이러한 특성을 클래스 및 클래스 멤버에 적절하게 적용한 다음 XmlSerializer를 사용하여 클래스의 인스턴스를 serialize합니다.Apply those attributes as appropriate to classes and members of classes, and then use the XmlSerializer to serialize instances of the class or classes.

다음 표에서는 특성, 해당 특성을 적용할 수 있는 위치 및 해당 특성이 수행하는 작업을 보여 줍니다.The following table shows the attributes, where they can be applied, and what they do. 이러한 특성을 사용하여 XML serialization을 제어하는 방법에 대한 자세한 내용은 방법: 개체를 SOAP 인코딩된 XML 스트림으로 직렬화방법: 인코딩된 SOAP XML Serialization 재정의를 참조하세요.For more information about using these attributes to control XML serialization, see How to: Serialize an Object as a SOAP-Encoded XML Stream and How to: Override Encoded SOAP XML Serialization.

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

특성Attribute 적용 대상Applies to 설명Specifies
SoapAttributeAttribute public 필드, 속성, 매개 변수 또는 반환 값입니다.Public field, property, parameter, or return value. 클래스 멤버는 XML 특성으로 serialize됩니다.The class member will be serialized as an XML attribute.
SoapElementAttribute public 필드, 속성, 매개 변수 또는 반환 값입니다.Public field, property, parameter, or return value. 클래스는 XML 요소로 serialize됩니다.The class will be serialized as an XML element.
SoapEnumAttribute 열거형 식별자인 public 필드입니다.Public field that is an enumeration identifier. 열거형 멤버의 요소 이름입니다.The element name of an enumeration member.
SoapIgnoreAttribute public 속성 및 필드입니다.Public properties and fields. 속성 또는 필드는 포함 클래스가 serialize될 때 무시되어야 합니다.The property or field should be ignored when the containing class is serialized.
SoapIncludeAttribute WSDL(웹 서비스 설명 언어) 문서에 대한 공용 파생 클래스 선언 및 공용 메서드입니다.Public-derived class declarations and public methods for Web Services Description Language (WSDL) documents. 스키마를 생성할 때 형식을 포함해야 합니다(serialize될 때 인식되도록).The type should be included when generating schemas (to be recognized when serialized).
SoapTypeAttribute public 클래스 선언입니다.Public class declarations. 클래스는 XML 형식으로 serialize되어야 합니다.The class should be serialized as an XML type.

참조See also