XmlAttributes.XmlArrayItems-Eigenschaft
Ruft eine Auflistung von Objekten ab, die die von XmlSerializer verwendete Serialisierung von Elementen angeben, die in ein von öffentlichen Feldern oder Lese-/Schreibeigenschaften zurückgegebenes Array eingefügt wurden, oder legt diese fest.
Namespace: System.Xml.Serialization
Assembly: System.Xml (in system.xml.dll)
Syntax
'Declaration
Public ReadOnly Property XmlArrayItems As XmlArrayItemAttributes
'Usage
Dim instance As XmlAttributes
Dim value As XmlArrayItemAttributes
value = instance.XmlArrayItems
public XmlArrayItemAttributes XmlArrayItems { get; }
public:
property XmlArrayItemAttributes^ XmlArrayItems {
XmlArrayItemAttributes^ get ();
}
/** @property */
public XmlArrayItemAttributes get_XmlArrayItems ()
public function get XmlArrayItems () : XmlArrayItemAttributes
Eigenschaftenwert
Ein XmlArrayItemAttributes-Objekt, das eine Auflistung von XmlArrayItemAttribute-Objekten enthält.
Hinweise
Mit der XmlArrayItems-Eigenschaft geben Sie die abgeleiteten Typen an, die in ein Array eingefügt werden können, das von öffentlichen Feldern oder Lese-/Schreibeigenschaften zurückgegeben wird. Erstellen Sie für jeden neuen Typ, der für das Feld oder die Eigenschaft zulässig sein soll, ein XmlArrayItemAttribute-Objekt, und fügen Sie es mit Add den XmlArrayItemAttributes hinzu, die von der XmlArrayItems-Eigenschaft zurückgegeben werden. (Der neue Typ muss von dem Typ abgeleitet sein, der bereits für das Feld oder die Eigenschaft zulässig ist.) Fügen Sie mit Add das XmlAttributes-Objekt einem XmlAttributeOverrides-Objekt hinzu. Geben Sie dabei den Typ des Objekts, das das Feld oder die Eigenschaft enthält, sowie den Namen des Felds oder der Eigenschaft an. Erstellen Sie einen XmlSerializer mit dem XmlAttributeOverrides-Objekt, bevor Sie die Serialize-Methode oder die Deserialize-Methode aufrufen.
Beispiel
Im folgenden Beispiel wird eine Klasse serialisiert, die das Feld Members enthält, welches ein Array von Objekten zurückgibt. Es werden zwei XmlArrayItemAttribute-Objekte erstellt, die es dem Feld ermöglichen, die von der Basisklasse Member abgeleiteten Objekte zu akzeptieren. Alle Objekte werden XmlAttributes über die XmlArrayItems-Eigenschaft hinzugefügt.
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
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);
}
}
}
#using <System.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Serialization;
public ref class Member
{
public:
String^ MemberName;
};
// This is the class that will be serialized.
public ref class Group
{
public:
array<Member^>^Members;
};
public ref class NewMember: public Member
{
public:
int MemberID;
};
public ref class RetiredMember: public NewMember
{
public:
DateTime RetireDate;
};
// Return an XmlSerializer used for overriding.
XmlSerializer^ CreateOverrider()
{
// Create XmlAttributeOverrides and XmlAttributes objects.
XmlAttributeOverrides^ xOver = gcnew XmlAttributeOverrides;
XmlAttributes^ xAttrs = gcnew XmlAttributes;
// Add an override for the XmlArrayItem.
XmlArrayItemAttribute^ xArrayItem = gcnew XmlArrayItemAttribute( NewMember::typeid );
xArrayItem->Namespace = "http://www.cpandl.com";
xAttrs->XmlArrayItems->Add( xArrayItem );
// Add a second override.
XmlArrayItemAttribute^ xArrayItem2 = gcnew XmlArrayItemAttribute( RetiredMember::typeid );
xArrayItem2->Namespace = "http://www.cpandl.com";
xAttrs->XmlArrayItems->Add( xArrayItem2 );
// Add all overrides to XmlAttribueOverrides object.
xOver->Add( Group::typeid, "Members", xAttrs );
// Create the XmlSerializer and return it.
return gcnew XmlSerializer( Group::typeid,xOver );
}
void SerializeObject( String^ filename )
{
// Create an instance of the XmlSerializer class.
XmlSerializer^ mySerializer = CreateOverrider();
// Writing the file requires a TextWriter.
TextWriter^ writer = gcnew StreamWriter( filename );
// Create an instance of the class that will be serialized.
Group^ myGroup = gcnew Group;
// Set the object properties.
NewMember^ m = gcnew NewMember;
m->MemberName = "Paul";
m->MemberID = 2;
// Create a second member.
RetiredMember^ m2 = gcnew RetiredMember;
m2->MemberName = "Renaldo";
m2->MemberID = 23;
m2->RetireDate = DateTime(2000,10,10);
array<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 = gcnew FileStream( filename,FileMode::Open );
Group^ myGroup = dynamic_cast<Group^>(mySerializer->Deserialize( fs ));
System::Collections::IEnumerator^ myEnum = myGroup->Members->GetEnumerator();
while ( myEnum->MoveNext() )
{
Member^ m = safe_cast<Member^>(myEnum->Current);
Console::WriteLine( m->MemberName );
}
}
int main()
{
SerializeObject( "OverrideArrayItem.xml" );
DeserializeObject( "OverrideArrayItem.xml" );
}
import System.*;
import System.IO.*;
import System.Xml.*;
import System.Xml.Serialization.*;
// This is the class that will be serialized.
public class Group
{
public Member members[];
} //Group
public class Member
{
public String memberName;
} //Member
public class NewMember extends Member
{
public int memberID;
} //NewMember
public class RetiredMember extends NewMember
{
public DateTime retireDate;
} //RetiredMember
public class Run
{
public static void main(String[] args)
{
Run test = new Run();
test.SerializeObject("OverrideArrayItem.xml");
test.DeserializeObject("OverrideArrayItem.xml");
} //main
// 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(NewMember.class.ToType());
xArrayItem.set_Namespace("http://www.cpandl.com");
xAttrs.get_XmlArrayItems().Add(xArrayItem);
// Add a second override.
XmlArrayItemAttribute xArrayItem2 =
new XmlArrayItemAttribute(RetiredMember.class.ToType());
xArrayItem2.set_Namespace("http://www.cpandl.com");
xAttrs.get_XmlArrayItems().Add(xArrayItem2);
// Add all overrides to XmlAttribueOverrides object.
xOver.Add(Group.class.ToType(), "members", xAttrs);
// Create the XmlSerializer and return it.
return new XmlSerializer(Group.class.ToType(), xOver);
} //CreateOverrider
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[] { m, m2 };
// Serialize the class, and close the TextWriter.
mySerializer.Serialize(writer, myGroup);
writer.Close();
} //SerializeObject
public void DeserializeObject(String fileName)
{
XmlSerializer mySerializer = CreateOverrider();
FileStream fs = new FileStream(fileName, FileMode.Open);
Group myGroup = (Group)mySerializer.Deserialize(fs);
for (int iCtr = 0; iCtr < myGroup.members.length; iCtr++) {
Member m = myGroup.members[iCtr];
Console.WriteLine(m.memberName);
}
} //DeserializeObject
} //Run
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
XmlAttributes-Klasse
XmlAttributes-Member
System.Xml.Serialization-Namespace