다음을 통해 공유


DataContractSerializer 클래스

정의

제공된 데이터 계약을 사용하여 특정 형식의 인스턴스를 XML 스트림 또는 문서로 직렬화 및 역직렬화합니다. 이 클래스는 상속될 수 없습니다.

public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer
상속
DataContractSerializer

설명

이 API에 대한 자세한 내용은 DataContractSerializer에 대한 추가 API 설명을 참조하세요.

생성자

DataContractSerializer(Type)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다.

DataContractSerializer(Type, DataContractSerializerSettings)

DataContractSerializer 클래스의 새 인스턴스를 초기화하여 지정된 형식 및 설정의 개체를 직렬화하거나 역직렬화합니다.

DataContractSerializer(Type, IEnumerable<Type>)

지정된 형식의 개체와 개체 그래프에 있을 수 있는 알려진 형식의 컬렉션을 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 또한 이 메서드는 개체 그래프에 있을 수 있는 알려진 형식의 목록, serialize할 최대 그래프 항목 수, 예기치 않은 데이터를 무시할 매개 변수, 비표준 XML 구문을 사용하여 그래프에서 개체 참조 데이터를 유지할지 여부, 사용자 지정 serialization을 위한 서로게이트를 지정합니다.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 또한 이 메서드는 개체 그래프에 있을 수 있는 알려진 형식의 목록, serialize할 최대 그래프 항목 수, 예기치 않은 데이터를 무시할 매개 변수, 비표준 XML 구문을 사용하여 그래프에서 개체 참조 데이터를 유지할지 여부, 사용자 지정 serialization을 위한 서로게이트 및 런타임에 xsi:type 선언을 매핑하기 위한 대안을 지정합니다.

DataContractSerializer(Type, String, String)

제공된 XML 루트 요소 및 네임스페이스를 사용하여 지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다.

DataContractSerializer(Type, String, String, IEnumerable<Type>)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 이 메서드는 두 문자열 매개 변수에 루트 XML 요소와 네임스페이스를 지정하고, 개체 그래프에 있을 수 있는 알려진 형식의 목록을 지정합니다.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 또한 이 메서드는 개체 그래프에 있을 수 있는 알려진 형식의 목록, serialize할 최대 그래프 항목 수, 예기치 않은 데이터를 무시할 매개 변수, 비표준 XML 구문을 사용하여 그래프에서 개체 참조 데이터를 유지할지 여부, 사용자 지정 serialization을 위한 서로게이트 및 콘텐츠가 들어 있는 XML 요소와 네임스페이스를 지정합니다.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 또한 이 메서드는 개체 그래프에 있을 수 있는 알려진 형식의 목록, serialize할 최대 그래프 항목 수, 예기치 않은 데이터를 무시할 매개 변수, 비표준 XML 구문을 사용하여 그래프에서 개체 참조 데이터를 유지할지 여부, 사용자 지정 serialization을 위한 서로게이트, 콘텐츠를 포함하는 XML 요소와 네임스페이스, 그리고 런타임에 xsi:type 선언을 매핑하기 위한 대안을 지정합니다.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

DataContractSerializer 형식의 매개 변수를 통해 지정된 XML 루트 요소 및 네임스페이스를 사용하여 지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 XmlDictionaryString 클래스의 새 인스턴스를 초기화합니다.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 이 메서드는 두 개의 XmlDictionaryString 매개 변수에 루트 XML 요소와 네임스페이스를 지정하고, 개체 그래프에 있을 수 있는 알려진 형식의 목록을 지정합니다.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 또한 이 메서드는 개체 그래프에 있을 수 있는 알려진 형식의 목록, serialize할 최대 그래프 항목 수, 예기치 않은 데이터를 무시할 매개 변수, 비표준 XML 구문을 사용하여 그래프에서 개체 참조 데이터를 유지할지 여부, 사용자 지정 serialization을 위한 서로게이트, 콘텐츠가 포함된 XML 요소와 네임스페이스를 지정하는 XmlDictionaryString의 매개 변수를 지정합니다.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

지정된 형식의 개체를 직렬화하거나 역직렬화하기 위해 DataContractSerializer 클래스의 새 인스턴스를 초기화합니다. 또한 이 메서드는 개체 그래프에 있을 수 있는 알려진 형식의 목록, serialize할 최대 그래프 항목 수, 예기치 않은 데이터를 무시할 매개 변수, 비표준 XML 구문을 사용하여 그래프에서 개체 참조 데이터를 유지할지 여부, 사용자 지정 serialization을 위한 서로게이트, 콘텐츠를 포함하는 XML 요소 및 네임스페이스를 지정하는 XmlDictionaryString 매개 변수, 그리고 런타임에 xsi:type 선언을 매핑하기 위한 대안을 지정합니다.

속성

DataContractResolver

xsi:type 선언을 알려진 계약 형식에 동적으로 매핑하는 데 사용되는 구성 요소를 가져옵니다.

DataContractSurrogate

serialization 또는 deserialization 프로세스를 확장할 수 있는 서로게이트 형식을 가져옵니다.

IgnoreExtensionDataObject

클래스를 직렬화하거나 역직렬화할 때 해당 클래스의 확장에서 제공하는 데이터를 무시할지 여부를 지정하는 값을 가져옵니다.

KnownTypes

DataContractSerializer의 이 인스턴스를 사용하여 serialize된 개체 그래프에 있을 수 있는 형식의 컬렉션을 가져옵니다.

MaxItemsInObjectGraph

개체 그래프에서 직렬화하거나 역직렬화할 최대 항목 수를 가져옵니다.

PreserveObjectReferences

비표준 XML 구문을 사용하여 개체 참조 데이터를 유지할지 여부를 지정하는 값을 가져옵니다.

SerializeReadOnlyTypes

읽기 전용 형식을 serialize하는지 여부를 지정하는 값을 가져옵니다.

메서드

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
IsStartObject(XmlDictionaryReader)

역직렬화할 수 있는 개체에 XmlDictionaryReader가 배치되는지 여부를 확인합니다.

IsStartObject(XmlReader)

역직렬화할 수 있는 개체에 XmlReader가 배치되는지 여부를 확인합니다.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
ReadObject(Stream)

Stream을 사용하여 XML 스트림 또는 문서를 읽고 역직렬화된 개체를 반환합니다.

(다음에서 상속됨 XmlObjectSerializer)
ReadObject(XmlDictionaryReader)

XmlDictionaryReader를 사용하여 XML 문서 또는 스트림을 읽고 역직렬화된 개체를 반환합니다.

(다음에서 상속됨 XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)

XmlDictionaryReader를 사용하여 XML 스트림을 읽고 역직렬화된 개체를 반환하며, 값을 읽기 전에 개체 이름을 확인하는지 여부도 지정합니다.

ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)

XML 문서 또는 문서 스트림을 읽고 역직렬화된 개체를 반환합니다. 메서드에는 확인된 개체 이름의 유효성 검사 여부를 지정하는 매개 변수와 런타임에 xsi:type 선언을 매핑하기 위한 확인자가 포함됩니다.

ReadObject(XmlReader)

XmlReader를 사용하여 XML 스트림을 읽고 역직렬화된 개체를 반환합니다.

ReadObject(XmlReader, Boolean)

XmlReader를 사용하여 XML 스트림을 읽고 역직렬화된 개체를 반환하며, 값을 읽기 전에 개체 이름을 확인하는지 여부도 지정합니다.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)
WriteEndObject(XmlDictionaryWriter)

XmlDictionaryWriter를 사용하여 닫기 XML 요소를 씁니다.

WriteEndObject(XmlWriter)

XmlWriter를 사용하여 닫기 XML 요소를 씁니다.

WriteObject(Stream, Object)

지정된 Stream를 사용하여 XML 문서 또는 스트림에 개체의 전체 콘텐츠(시작, 콘텐츠, 끝)를 씁니다.

(다음에서 상속됨 XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)

지정된 XmlDictionaryWriter를 사용하여 XML 문서 또는 스트림에 개체의 전체 콘텐츠(시작, 콘텐츠, 끝)를 씁니다.

(다음에서 상속됨 XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)

지정된 XmlDictionaryWriter를 사용하여 모든 개체 데이터(XML 요소, 콘텐츠 및 묶는 요소 시작)를 XML 문서 또는 스트림에 씁니다. 메서드에는 런타임에 xsi:type 선언을 매핑하기 위한 확인자가 포함됩니다.

WriteObject(XmlWriter, Object)

XmlWriter를 사용하여 XML 문서 또는 스트림에 모든 개체 데이터(시작 XML 요소, 콘텐츠, 닫기 요소)를 씁니다.

WriteObjectContent(XmlDictionaryWriter, Object)

XmlDictionaryWriter를 사용하여 XML 콘텐츠를 씁니다.

WriteObjectContent(XmlWriter, Object)

XmlWriter를 사용하여 XML 콘텐츠를 씁니다.

WriteStartObject(XmlDictionaryWriter, Object)

XmlDictionaryWriter를 사용하여 열기 XML 요소를 씁니다.

WriteStartObject(XmlWriter, Object)

XmlWriter를 사용하여 열기 XML 요소를 씁니다.

확장 메서드

GetSerializationSurrogateProvider(DataContractSerializer)

이 직렬 변환기의 서로게이트 serialization 공급자를 반환합니다.

SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)

DataContractSerializer의 서로게이트 serialization 공급자를 지정합니다.

적용 대상

스레드 보안

이 클래스의 인스턴스는 instance 또는 DataContractResolverIDataContractSurrogate 구현과 함께 사용되는 경우를 제외하고 스레드로부터 안전합니다.

추가 정보