직렬화 및 메타데이터

  • 아티클

앱이 개체를 직렬화 및 역직렬화하는 경우에는 런타임에 필요한 메타데이터가 제공되도록 런타임 지시문(.rd.xml) 파일에 항목을 추가해야 할 수 있습니다. serializer에는 두 가지 범주가 있으며 각 범주는 런타임 지시문 파일에서 서로 다른 방식으로 처리해야 합니다.

  • 리플렉션 기반 타사 serializer. 이러한 serializer의 경우 런타임 지시문 파일을 수정해야 합니다. 여기에 대해서는 다음 섹션에서 설명합니다.

  • .NET Framework 클래스 라이브러리에 있는 리플렉션이 아닌 직렬 변환기입니다. 이러한 직렬 변환기의 경우 런타임 지시문 파일을 수정해야 할 수도 있습니다. 아래의 Microsoft 직렬 변환기 섹션에서 여기에 대해 설명합니다.

타사 serializer

Newtonsoft.JSON을 비롯한 타사 직렬 변환기는 대개 리플렉션을 기반으로 합니다. serialize된 데이터의 BLOB(Binary Large Object)가 지정되면 데이터의 필드는 대상 형식의 필드를 이름으로 조회하여 구체적 형식에 할당됩니다. 이러한 라이브러리를 사용하는 경우 List<Type> 컬렉션에서 직렬화 또는 역직렬화하려는 각 Type 개체에 대해 최소한 MissingMetadataException 예외가 발생합니다.

이러한 serializer용 메타데이터 누락으로 인해 발생하는 문제를 해결하는 가장 쉬운 방법은 serialization에 사용할 형식을 App.Models와 같은 네임스페이스 하나에 수집하고 해당 네임스페이스에 Serialize 메타데이터 지시문을 적용하는 것입니다.

<Namespace Name="App.Models" Serialize="Required PublicAndInternal" />

이 예에 사용된 구문에 대한 자세한 내용은 <Namespace> 요소를 참조하세요.

Microsoft serializer

DataContractSerializer, DataContractJsonSerializer 및 XmlSerializer 클래스는 리플렉션을 사용하지는 않지만 직렬화 또는 역직렬화하려는 코드를 기반으로 코드는 생성해야 합니다. 각 직렬 변환기의 오버로드된 생성자는 직렬화 또는 역직렬화할 형식을 지정하는 Type 매개 변수를 포함합니다. 코드에서 해당 형식을 지정하는 방법에 따라 수행해야 하는 작업이 정의됩니다. 여기에 대해서는 다음 두 섹션에서 설명합니다.

생성자 내부에서 사용되는 typeof

이러한 직렬화 클래스의 생성자를 호출하고 메서드 호출에 C# typeof 연산자를 포함하면 추가 작업을 수행할 필요가 없습니다. 예를 들어 serialization 클래스 생성자에 대한 다음의 각 호출에서 typeof 키워드는 생성자에 전달되는 식의 일부로 사용됩니다.

XmlSerializer xmlSer = new XmlSerializer(typeof(T));
DataContractSerializer dataSer = new DataContractSerializer(typeof(T));
DataContractJsonSerializer jsonSer = new DataContractJsonSerializer(typeof(T));

.NET 네이티브 컴파일러는 이 코드를 자동으로 처리합니다.

생성자 외부에서 사용되는 typeof

다음 코드와 같이 이러한 직렬화 클래스의 생성자를 호출하고 생성자의 Type 매개 변수에 제공된 표현식 외부에서 C# typeof 연산자를 사용하는 경우 .NET 네이티브 컴파일러는 유형을 확인할 수 없습니다.

Type t = typeof(DataSet);
XmlSerializer ser = new XmlSerializer(t);

이 경우 다음과 같은 항목을 추가하여 런타임 지시문 파일에서 형식을 지정해야 합니다.

<Type Name="DataSet" Browse="Required Public" />

마찬가지로, 다음 코드와 같이 XmlSerializer(Type, Type[])과 같은 생성자를 호출하고 직렬화할 추가 Type 개체의 배열을 제공하는 경우 .NET 네이티브 컴파일러는 이러한 유형을 확인할 수 없습니다.

XmlSerializer xSerializer = new XmlSerializer(typeof(Teacher),
                            new Type[] { typeof(Student),
                                         typeof(Course),
                                         typeof(Location) });

런타임 지시문 파일에 각 유형에 대해 다음과 같은 항목을 추가합니다.

<Type Name="t" Browse="Required Public" />

이 예에 사용된 구문에 대한 자세한 내용은 <Type> 요소를 참조하세요.

참고 항목