XmlAttributes.XmlArray 속성

정의

네임스페이스:

System.Xml.Serialization

어셈블리:

netstandard.dll, System.Xml.XmlSerializer.dll

Source:

XmlAttributes.cs

배열을 반환하는 공용 필드 또는 읽기/쓰기 속성을 serialize하는 방법을 XmlSerializer 지정하는 개체를 가져오거나 설정합니다.

public:
 property System::Xml::Serialization::XmlArrayAttribute ^ XmlArray { System::Xml::Serialization::XmlArrayAttribute ^ get(); void set(System::Xml::Serialization::XmlArrayAttribute ^ value); };

public System.Xml.Serialization.XmlArrayAttribute? XmlArray { get; set; }

member this.XmlArray : System.Xml.Serialization.XmlArrayAttribute with get, set

Public Property XmlArray As XmlArrayAttribute

속성 값

XmlArrayAttribute

XmlArrayAttribute 배열을 반환하는 공용 필드 또는 읽기/쓰기 속성을 serialize하는 방법을 XmlSerializer 지정하는 값입니다.

예제

다음 예제에서는 개체 배열을 반환하는 필드 Members 가 포함된 클래스를 serialize합니다. 필드 XmlArrayAttribute 의 serialization을 재정의하고 요소 이름의 Staff이름을 .로 바꾸는 데 사용됩니다.

using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;

// This is the class that will be serialized.
public class Group
{
   // This field will be overridden.
   public Member [] Members;
}

public class Member
{
   public string MemberName;
}

public class Run
{
   public static void Main()
   {
      Run test = new Run();
      test.SerializeObject("OverrideArray.xml");
      test.DeserializeObject("OverrideArray.xml");
   }
   // Return an XmlSerializer used for overriding.
   public XmlSerializer CreateOverrider()
   {
      // Creating XmlAttributeOverrides and XmlAttributes objects.
      XmlAttributeOverrides xOver = new XmlAttributeOverrides();
      XmlAttributes xAttrs = new XmlAttributes();

      // Add an override for the XmlArray.
      XmlArrayAttribute xArray = new XmlArrayAttribute("Staff");
      xArray.Namespace = "http://www.cpandl.com";
      xAttrs.XmlArray = xArray;
      xOver.Add(typeof(Group), "Members", xAttrs);

      // Create the XmlSerializer and return it.
      return new XmlSerializer(typeof(Group), xOver);
   }

   public void SerializeObject(string filename)
   {
      // Create an instance of the XmlSerializer class.
      XmlSerializer mySerializer =  CreateOverrider();
      // Writing the file requires a TextWriter.
      TextWriter writer = new StreamWriter(filename);

      // Create an instance of the class that will be serialized.
      Group myGroup = new Group();

      // Set the object properties.
      Member m = new Member();
      m.MemberName = "Paul";
      myGroup.Members = new Member[1] {m};

      // Serialize the class, and close the TextWriter.
      mySerializer.Serialize(writer, myGroup);
      writer.Close();
   }

   public void DeserializeObject(string filename)
   {
      XmlSerializer mySerializer = CreateOverrider();
      FileStream fs = new FileStream(filename, FileMode.Open);
      Group myGroup = (Group)
      mySerializer.Deserialize(fs);
      foreach(Member m in myGroup.Members)
      {
         Console.WriteLine(m.MemberName);
      }
   }
}

Imports System.IO
Imports System.Xml
Imports System.Xml.Serialization


' This is the class that will be serialized.
Public Class Group
    ' This field will be overridden.
    Public Members() As Member
End Class

Public Class Member
    Public MemberName As String
End Class

Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("OverrideArray.xml")
        test.DeserializeObject("OverrideArray.xml")
    End Sub
    
    ' Return an XmlSerializer used for overriding. 
    Public Function CreateOverrider() As XmlSerializer
        ' Creating XmlAttributeOverrides and XmlAttributes objects.
        Dim xOver As New XmlAttributeOverrides()
        Dim xAttrs As New XmlAttributes()
        
        ' Add an override for the XmlArray.    
        Dim xArray As New XmlArrayAttribute("Staff")
        xArray.Namespace = "http://www.cpandl.com"
        xAttrs.XmlArray = xArray
        xOver.Add(GetType(Group), "Members", xAttrs)
        
        ' Create the XmlSerializer and return it.
        Return New XmlSerializer(GetType(Group), xOver)
    End Function
    
    Public Sub SerializeObject(ByVal filename As String)
        ' Create an instance of the XmlSerializer class.
        Dim mySerializer As XmlSerializer = CreateOverrider()
        ' Writing the file requires a TextWriter.
        Dim writer As New StreamWriter(filename)
        
        ' Create an instance of the class that will be serialized.
        Dim myGroup As New Group()
        
        ' Set the object properties.
        Dim m As New Member()
        m.MemberName = "Paul"
        myGroup.Members = New Member(0) {m}
        
        ' Serialize the class, and close the TextWriter.
        mySerializer.Serialize(writer, myGroup)
        writer.Close()
    End Sub    
    
    Public Sub DeserializeObject(ByVal filename As String)
        Dim mySerializer As XmlSerializer = CreateOverrider()
        Dim fs As New FileStream(filename, FileMode.Open)
        Dim myGroup As Group = CType(mySerializer.Deserialize(fs), Group)
        Dim m As Member
        For Each m In  myGroup.Members
            Console.WriteLine(m.MemberName)
        Next m
    End Sub
End Class

설명

배열을 반환하는 공용 필드 또는 공용 읽기/쓰기 속성은 기본 serialization 및 제어된 serialization에 의해 XmlSerializerserialize되는 두 가지 방법이 있습니다.

기본 serialization에서는 멤버에 특성이 적용되지 않습니다. serialize될 때 배열은 멤버 이름에서 가져온 중첩 시퀀스의 XML 요소 이름을 사용하여 XML 요소의 중첩 시퀀스로 serialize됩니다.

serialization을 보다 정확하게 제어하려면 필드 또는 속성에 적용 XmlArrayAttribute 합니다. 예를 들어 속성을 새 값으로 설정 ElementName 하여 생성된 XML 요소 이름을 기본값에서 다른 이름으로 변경할 수 있습니다.

이 XmlArray 속성을 사용하면 멤버에 적용하여 제어되는 serialization뿐만 아니라 기본 serialization을 재정의할 수 있습니다 XmlArrayAttribute . 예를 들어 기본값(멤버 식별자)에서 생성된 XML 요소 이름을 새 값으로 변경할 수 있습니다. 또한 멤버에 XmlArrayAttribute 적용하는 경우 속성에 할당된 멤버에 의해 XmlArrayAttribute 재정의 XmlArray 됩니다.