XmlAttributes.XmlArrayItems プロパティ

[アーティクル]
03/28/2008

パブリックフィールドまたは読み書き可能プロパティによって返された配列に挿入されている項目を XmlSerializer によってシリアル化する方法を指定するオブジェクトのコレクションを取得または設定します。

Public ReadOnly Property XmlArrayItems As XmlArrayItemAttributes
[C#]
public XmlArrayItemAttributes XmlArrayItems {get;}
[C++]
public: __property XmlArrayItemAttributes* get_XmlArrayItems();
[JScript]
public function get XmlArrayItems() : XmlArrayItemAttributes;

プロパティ値

XmlArrayItemAttribute オブジェクトのコレクションを格納している XmlArrayItemAttributes オブジェクト。

解説

XmlArrayItems プロパティにより、パブリックフィールドまたは読み書き可能なパブリックプロパティが返した配列に挿入できる派生型を指定できます。フィールドやプロパティに新しい型を指定する場合、 XmlArrayItemAttribute オブジェクトを作成し、それを XmlArrayItems プロパティによって返される XmlArrayItemAttributes に Add メソッドを使用して追加します。指定できる新しい型は、フィールドまたはプロパティで既に指定できる型から派生した型である必要があります。フィールドまたはプロパティを含むオブジェクトの型およびフィールドまたはプロパティの名前を指定して XmlAttributes オブジェクトを XmlAttributeOverrides オブジェクトに Add メソッドにより追加します。 Serialize メソッドまたは Deserialize メソッドを呼び出す前に、 XmlAttributeOverrides オブジェクトで XmlSerializer を構築します。

使用例

[Visual Basic, C#, C++] オブジェクトの配列を返す Members という名前のフィールドを含むクラスをシリアル化する例を次に示します。2 つの XmlArrayItemAttribute オブジェクトが作成され、Member という名前の基本クラスから派生したオブジェクトをフィールドが受け入れるようになります。各オブジェクトは、 XmlArrayItems プロパティをとおして XmlAttributes に追加されます。

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


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

Public Class Member
    Public MemberName As String
End Class

Public Class NewMember
    Inherits Member
    Public MemberID As Integer
End Class

Public Class RetiredMember
    Inherits NewMember
    Public RetireDate As DateTime
End Class


Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("OverrideArrayItem.xml")
        test.DeserializeObject("OverrideArrayItem.xml")
    End Sub    
    
    ' Return an XmlSerializer used for overriding. 
    Public Function CreateOverrider() As XmlSerializer
        ' Create XmlAttributeOverrides and XmlAttributes objects.
        Dim xOver As New XmlAttributeOverrides()
        Dim xAttrs As New XmlAttributes()
        
        ' Add an override for the XmlArrayItem.    
        Dim xArrayItem As New XmlArrayItemAttribute(GetType(NewMember))
        xArrayItem.Namespace = "http://www.cpandl.com"
        xAttrs.XmlArrayItems.Add(xArrayItem)
        
        ' Add a second override.
        Dim xArrayItem2 As New XmlArrayItemAttribute(GetType(RetiredMember))
        xArrayItem2.Namespace = "http://www.cpandl.com"
        xAttrs.XmlArrayItems.Add(xArrayItem2)
        
        ' Add all overrides to XmlAttribueOverrides object.
        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 NewMember()
        m.MemberName = "Paul"
        m.MemberID = 2
        
        ' Create a second member.
        Dim m2 As New RetiredMember()
        m2.MemberName = "Renaldo"
        m2.MemberID = 23
        m2.RetireDate = New DateTime(2000, 10, 10)
        
        myGroup.Members = New Member(1) {m, m2}
        
        ' 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


[C#] 
using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;

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

public class Member
{
    public string MemberName;
}

public class NewMember:Member
{
    public int MemberID;
}

public class RetiredMember:NewMember
{
    public DateTime RetireDate;
}
    

public class Run
{
   public static void Main()
   {
      Run test = new Run();
      test.SerializeObject("OverrideArrayItem.xml");
      test.DeserializeObject("OverrideArrayItem.xml");
   }

   // Return an XmlSerializer used for overriding. 
   public XmlSerializer CreateOverrider()
   {
      // Create XmlAttributeOverrides and XmlAttributes objects.
      XmlAttributeOverrides xOver = new XmlAttributeOverrides();
      XmlAttributes xAttrs = new XmlAttributes();

      // Add an override for the XmlArrayItem.    
      XmlArrayItemAttribute xArrayItem = 
      new XmlArrayItemAttribute(typeof(NewMember));
      xArrayItem.Namespace = "http://www.cpandl.com";
      xAttrs.XmlArrayItems.Add(xArrayItem);

      // Add a second override.
      XmlArrayItemAttribute xArrayItem2 = 
      new XmlArrayItemAttribute(typeof(RetiredMember));
      xArrayItem2.Namespace = "http://www.cpandl.com";
      xAttrs.XmlArrayItems.Add(xArrayItem2);

      // Add all overrides to XmlAttribueOverrides object.
      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.
      NewMember m = new NewMember();
      m.MemberName = "Paul";
      m.MemberID = 2;

      // Create a second member.
      RetiredMember m2 = new RetiredMember();
      m2.MemberName = "Renaldo";
      m2.MemberID = 23;
      m2.RetireDate = new DateTime(2000, 10,10);

      myGroup.Members = new Member[2] {m, m2};
      
      // 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);
      }
   }
}
   

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Serialization;

public __gc class Member
{
public:
   String* MemberName;
};

// This is the class that will be serialized.
public __gc class Group
{
public:
   Member* Members[];
};

public __gc class NewMember:public Member
{
public:
   int MemberID;
};

public __gc class RetiredMember:public NewMember
{
public:
   DateTime RetireDate;
};

// Return an XmlSerializer used for overriding. 
XmlSerializer* CreateOverrider()
{
   // Create XmlAttributeOverrides and XmlAttributes objects.
   XmlAttributeOverrides* xOver = new XmlAttributeOverrides();
   XmlAttributes* xAttrs = new XmlAttributes();

   // Add an override for the XmlArrayItem.    
   XmlArrayItemAttribute* xArrayItem = 
      new XmlArrayItemAttribute(__typeof(NewMember));
   xArrayItem->Namespace = S"http://www.cpandl.com";
   xAttrs->XmlArrayItems->Add(xArrayItem);

   // Add a second override.
   XmlArrayItemAttribute* xArrayItem2 = 
      new XmlArrayItemAttribute(__typeof(RetiredMember));
   xArrayItem2->Namespace = S"http://www.cpandl.com";
   xAttrs->XmlArrayItems->Add(xArrayItem2);

   // Add all overrides to XmlAttribueOverrides object.
   xOver->Add(__typeof(Group), S"Members", xAttrs);

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

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.
   NewMember* m = new NewMember();
   m->MemberName = S"Paul";
   m->MemberID = 2;

   // Create a second member.
   RetiredMember* m2 = new RetiredMember();
   m2->MemberName = S"Renaldo";
   m2->MemberID = 23;
   m2->RetireDate = DateTime(2000, 10,10);

   Member* temp[] = {m, m2};
   myGroup->Members = temp;

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

void DeserializeObject(String* filename)
{
   XmlSerializer* mySerializer = CreateOverrider();
   FileStream* fs = new FileStream(filename, FileMode::Open);
   Group* myGroup = dynamic_cast<Group*>(mySerializer->Deserialize(fs));
   System::Collections::IEnumerator* myEnum = myGroup->Members->GetEnumerator();
   while (myEnum->MoveNext())
   {
      Member* m = __try_cast<Member*>(myEnum->Current);
      Console::WriteLine(m->MemberName);
   }
}

int main()
{
   SerializeObject(S"OverrideArrayItem.xml");
   DeserializeObject(S"OverrideArrayItem.xml");
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

XmlAttributes クラス | XmlAttributes メンバ | System.Xml.Serialization 名前空間

次の方法で共有

XmlAttributes.XmlArrayItems プロパティ

プロパティ値

解説

使用例

必要条件

参照

その他のリソース