다음을 통해 공유

System.Xml.Serialization 네임스페이스

  • 아티클

System.Xml.Serialization 네임스페이스는 개체를 XML 형식 문서나 스트림으로 serialize하는 데 사용되는 클래스를 포함하고 있습니다.

네임스페이스의 중심 클래스는 XmlSerializer 클래스입니다. 이 클래스를 사용하려면 XmlSerializer 생성자를 사용하여 serialize할 개체의 형식을 사용하는 클래스의 인스턴스를 만듭니다. XmlSerializer를 만든 다음 serialize할 개체의 인스턴스를 만듭니다. 또한 Stream, TextWriter 또는 XmlWriter와 같이 문서나 스트림에 파일을 쓸 개체를 만들어야 합니다. 그런 다음 Serialize 메서드를 호출하여 개체를 XML 문서로 변환할 수 있습니다.

XML 문서로부터 개체를 deserialize하려면 문서나 스트림을 읽을 적절한 개체를 만듭니다(예: Stream, TextWriter 또는 XmlWriter). 결과 개체를 serialize된 원래 개체의 형식으로 캐스팅하는 동안 Deserialize 메서드를 호출합니다.

serialization에 대한 추가 제어를 위해 System.Xml.Serialization 네임스페이스에는 클래스의 멤버에 적용될 수 있는 여러 Attribute 클래스가 포함되어 있습니다. 예를 들어, 클래스에 XML 요소로 serialize될 멤버가 있을 경우 해당 멤버에 XmlElementAttribute 특성을 적용할 수 있습니다. 특성을 적용할 때 ElementName 속성을 사용하여 실제 XML 요소 이름과 같은 정보를 지정할 수 있습니다. 모든 특성에 대한 전체 목록은 XmlSerializer 클래스 개요를 참조하십시오.

클래스

  클래스 설명
Public class CodeExporter 데이터 구조의 XML 표현에서 프록시 코드를 생성할 수 있는 클래스를 나타냅니다.
Public class CodeIdentifier 입력 텍스트를 코드 엔터티 이름으로 변환하는 정적 메서드를 제공합니다.
Public class CodeIdentifiers 관련 코드 엔터티 이름의 그룹이나 .NET Framework XML serialization 인프라에서 생성한 형식 매핑을 유지합니다.
Public class ImportContext 스키마 집합이 .NET Framework 코드 엔터티에 바인딩되는 컨텍스트를 설명합니다.
Public class SchemaImporter 스키마 가져오기를 설명합니다.
Public class SoapAttributeAttribute XmlSerializer가 클래스 멤버를 인코딩된 SOAP 특성으로 serialize하도록 지정합니다.
Public class SoapAttributeOverrides XmlSerializer를 사용하여 개체를 인코딩된 SOAP로 serialize하거나 deserialize하는 경우 속성, 필드 및 클래스에 적용된 특성을 재정의할 수 있습니다.
Public class SoapAttributes XmlSerializer가 SOAP 메서드를 serialize 및 deserialize하는 방식을 제어하는 특성 개체의 컬렉션을 나타냅니다.
Public class SoapCodeExporter WSDL 문서에 정의된 SOAP 인코딩된 메시지 부분에 대한 내부 형식 매핑 정보에서 형식 및 특성 선언을 생성합니다.
Public class SoapElementAttribute XmlSerializer에 의해 공용 멤버 값이 인코딩된 SOAP XML 요소로 serialize되도록 지정합니다.
Public class SoapEnumAttribute XmlSerializer가 열거형 멤버를 serialize하는 방식을 제어합니다.
Public class SoapIgnoreAttribute XmlSerializer를 호출하여 공용 필드 또는 공용 읽기/쓰기 속성 값을 serialize하지 않도록 합니다.
Public class SoapIncludeAttribute XmlSerializer가 개체를 인코딩된 SOAP XML로 serialize하거나 deserialize할 때 형식을 인식할 수 있게 합니다.
Public class SoapReflectionImporter .NET Framework 형식 또는 웹 서비스 메서드 정보에서 SOAP 인코딩된 메시지에 대한 매핑을 생성합니다.
Public class SoapSchemaExporter XmlSchema 개체를 SOAP 인코딩을 사용하여 serialize된 .NET Framework 형식에 대한 XML 스키마 데이터 형식 정의로 채웁니다.
Public class SoapSchemaImporter WSDL 문서에서 SOAP 인코딩된 메시지 부분에 대해 .NET Framework 형식으로 내부 매핑을 생성하기 위해 .NET Framework 에서 사용됩니다.
Public class SoapSchemaMember 문서에서 클래스를 생성하는 데 사용할 WSDL 문서의 XSD <part> 요소에 대한 특정 특성을 나타냅니다.
Public class SoapTypeAttribute 클래스 인스턴스를 SOAP 인코딩된 XML로 serialize할 때 XmlSerializer에 의해 생성되는 스키마를 제어합니다.
Public class UnreferencedObjectEventArgs deserialization 중에 암호화된 SOAP XML 스트림에서 발견한 알 수는 있지만 참조되지 않은 개체에 데이터를 제공합니다.
Public class XmlAnyAttributeAttribute 멤버(XmlAttribute 개체의 배열을 반환하는 필드)가 XML 특성을 포함할 수 있도록 지정합니다.
Public class XmlAnyElementAttribute 멤버(XmlElement 또는 XmlNode 개체의 배열을 반환하는 필드)가 serialize 또는 deserialize되고 있는 개체에 해당 멤버가 없는 XML 요소를 나타내는 개체를 포함하도록 지정합니다.
Public class XmlAnyElementAttributes XmlAnyElementAttribute 개체의 컬렉션을 나타냅니다.
Public class XmlArrayAttribute XmlSerializer가 특정 클래스 멤버를 XML 요소의 배열로 serialize하도록 지정합니다.
Public class XmlArrayItemAttribute XmlSerializer가 serialize된 배열에 배치할 수 있는 파생 형식을 지정합니다.
Public class XmlArrayItemAttributes XmlArrayItemAttribute 개체의 컬렉션을 나타냅니다.
Public class XmlAttributeAttribute XmlSerializer가 해당 클래스 멤버를 XML 특성으로 serialize하도록 지정합니다.
Public class XmlAttributeEventArgs UnknownAttribute 이벤트에 대한 데이터를 제공합니다.
Public class XmlAttributeOverrides XmlSerializer를 사용하여 개체를 serialize하거나 deserialize하면 속성, 필드 및 클래스 특성을 재정의할 수 있습니다.
Public class XmlAttributes XmlSerializer가 개체를 serialize 및 deserialize하는 방식을 제어하는 특성 개체의 컬렉션을 나타냅니다.
Public class XmlChoiceIdentifierAttribute 열거형을 사용하여 멤버를 추가로 검색할 수 있음을 지정합니다.
Public class XmlCodeExporter XML 스키마 요소 선언에 대한 내부 형식 매핑 정보에서 형식과 특성 선언을 생성합니다.
Public class XmlElementAttribute 공용 필드 또는 속성을 포함하는 개체를 XmlSerializer가 serialize하거나 deserialize할 때 해당 필드나 속성이 XML 요소를 나타냄을 의미합니다.
Public class XmlElementAttributes XmlSerializer가 클래스를 serialize하는 기본 방식을 재정의하는 데 사용하는 XmlElementAttribute 개체의 컬렉션을 나타냅니다.
Public class XmlElementEventArgs UnknownElement 이벤트에 대한 데이터를 제공합니다.
Public class XmlEnumAttribute XmlSerializer가 열거형 멤버를 serialize하는 방식을 제어합니다.
Public class XmlIgnoreAttribute XmlSerializer의 Serialize 메서드를 호출하여 공용 필드 또는 공용 읽기/쓰기 속성 값을 serialize하지 않도록 합니다.
Public class XmlIncludeAttribute XmlSerializer가 개체를 serialize하거나 deserialize할 때 파생 클래스를 인식할 수 있게 합니다.
Public class XmlMapping .NET Framework 형식과 XML 스키마 데이터 형식 사이의 매핑을 지원합니다.
Public class XmlMemberMapping .NET Framework 웹 서비스 메서드의 코드 엔터티를 WSDL(Web Services Description Language) 메시지의 요소로 매핑합니다.
Public class XmlMembersMapping .NET Framework 웹 서비스 메서드와 SOAP 웹 서비스에 대해 정의된 WSDL(Web Services Description Language) 메시지 간의 매핑을 제공합니다.
Public class XmlNamespaceDeclarationsAttribute 대상 속성, 매개 변수, 반환 값 또는 클래스 멤버가 XML 문서 내에서 사용되는 네임스페이스와 연관된 접두사를 포함하도록 지정합니다.
Public class XmlNodeEventArgs UnknownNode 이벤트에 대한 데이터를 제공합니다.
Public class XmlReflectionImporter WSDL(Web Services Description Language) 문서의 리터럴 XSD(XML 스키마 정의) 메시지 부분을 포함하는 XML 스키마 요소 선언과 .NET Framework 형식 또는 웹 서비스 메서드 정보의 매핑을 생성합니다.
Public class XmlReflectionMember .NET Framework 웹 서비스 메서드의 코드 엔터티와 SOAP 웹 서비스에 대해 정의된 WSDL(Web Services Description Language) 메시지 내용 간의 매핑을 제공합니다.
Public class XmlRootAttribute 특성 대상의 XML serialization을 XML 루트 요소로 제어합니다.
Public class XmlSchemaEnumerator XmlSchema 개체의 컬렉션에 대해 반복을 가능하게 합니다.
Public class XmlSchemaExporter XmlSchema 개체를 형식 매핑 개체에 있는 XML 스키마 요소 선언으로 채웁니다.
Public class XmlSchemaImporter WSDL 문서의 리터럴 XSD 메시지 부분을 포함하여 XML 스키마 요소 선언에 대한 .NET Framework 형식의 내부 매핑을 생성합니다.
Public class XmlSchemaProviderAttribute 형식에 적용되는 경우 XML 스키마를 반환하는 형식의 정적 메서드 이름과 형식의 serialization을 제어하는 XmlQualifiedName을 저장합니다.
Public class XmlSchemas XML 스키마의 컬렉션을 나타냅니다.
Public class XmlSerializationGeneratedCode XmlSerializationReader 및 XmlSerializationWriter를 위한 기본 클래스일 뿐 아니라 이 두 가지 형식 모두에 공통으로 사용되는 메서드를 포함하는 추상 클래스입니다.
Public class XmlSerializationReader XmlSerializer 클래스로 deserialization을 제어합니다.
Public class XmlSerializationReader.CollectionFixup XmlSerializationCollectionFixupCallback 대리자 인스턴스와 메서드의 입력을 포함하며 메서드의 매개 변수도 제공합니다.
Public class XmlSerializationReader.Fixup XmlSerializationFixupCallback 대리자 인스턴스와 메서드의 입력을 포함하며 메서드의 매개 변수 역할을 합니다.
Public class XmlSerializationWriter XmlSerializer 클래스에서 serialization을 제어하는 데 사용되는 추상 클래스입니다.
Public class XmlSerializer XML 문서 간에 개체를 serialize 및 deserialize합니다. XmlSerializer를 사용하면 개체가 XML로 인코딩되는 방식을 제어할 수 있습니다.
Public class XmlSerializerAssemblyAttribute 웹 서비스 클라이언트 프록시에 적용되며 사용자 지정 serializer를 포함하는 어셈블리를 지정할 수 있습니다.
Public class XmlSerializerFactory 보다 효율적인 serialization을 위해 XmlSerializer의 형식화된 버전을 만듭니다.
Public class XmlSerializerImplementation 미리 생성한 형식화된 serializer의 판독기, 작성기 및 메서드를 정의합니다.
Public class XmlSerializerNamespaces XmlSerializer가 XML 문서 인스턴스에서 정규화된 이름을 생성하는 데 사용하는 XML 네임스페이스 및 접두사를 포함합니다.
Public class XmlSerializerVersionAttribute 이 특성이 어셈블리에 적용되는 경우 코드가 serialization 인프라에서 생성되었고 성능 향상을 위해 다시 사용될 수 있음을 나타냅니다.
Public class XmlTextAttribute 멤버가 포함된 클래스가 serialize되거나 deserialize될 때 멤버를 XML 텍스트로 처리하도록 XmlSerializer에 지정합니다.
Public class XmlTypeAttribute XmlSerializer가 특성 대상을 serialize할 때 생성되는 XML 스키마를 제어합니다.
Public class XmlTypeMapping 한 형식과 다른 형식의 매핑을 포함합니다.

인터페이스

  인터페이스 설명
Public interface IXmlSerializable XML serialization 및 deserialization을 위한 사용자 지정 서식을 제공합니다.
Public interface IXmlTextParser .NET Framework 인프라에서 사용할 Normalized 속성을 설정합니다.

구조체

  구조체 설명
Public structure XmlDeserializationEvents XmlSerializer의 스레드로부터 안전한 Deserialize 메서드에 이벤트 대리자를 전달하는 데 사용할 수 있는 필드를 포함합니다.

대리자

  대리자 설명
Public delegate UnreferencedObjectEventHandler XmlSerializer의 UnreferencedObject 이벤트를 처리하는 메서드를 나타냅니다.
Public delegate XmlAttributeEventHandler UnknownAttribute를 처리하는 메서드를 나타냅니다.
Public delegate XmlElementEventHandler XmlSerializer의 UnknownElement 이벤트를 처리하는 메서드를 나타냅니다.
Public delegate XmlNodeEventHandler XmlSerializer의 UnknownNode 이벤트를 처리하는 메서드를 나타냅니다.
Public delegate XmlSerializationCollectionFixupCallback 컬렉션 또는 열거형에 매핑되는 SOAP 인코딩된 XML 데이터 형식을 deserialize하기 위해 XmlSerializer 클래스에서 사용하는 대리자입니다.
Public delegate XmlSerializationFixupCallback SOAP 인코딩된 XML 데이터를 deserialize하기 위해 XmlSerializer 클래스에서 사용하는 대리자입니다.
Public delegate XmlSerializationReadCallback SOAP로 인코딩된 루트가 아닌 XML 데이터에서 형식을 deserialize하기 위해 XmlSerializer 클래스에서 사용하는 대리자입니다.
Public delegate XmlSerializationWriteCallback SOAP로 인코딩된 루트가 아닌 XML 데이터에서 형식을 serialize하기 위해 XmlSerializer 클래스에서 사용하는 대리자입니다.

열거형

  열거형 설명
Public enumeration CodeGenerationOptions XML Web services 사용을 위해 .NET Framework 형식을 생성할 때 사용할 다양한 옵션을 지정합니다.
Public enumeration XmlMappingAccess 매핑이 읽기, 쓰기 또는 둘 다인지 여부를 지정합니다.