Type: System.Xml.Serialization.XmlElementAttributes

System.Xml.Serialization.XmlElementAttributes Class

Assembly: System.Xml.dll
Namespace: System.Xml.Serialization

Summary: Represents a collection of XmlElementAttribute, which the XmlSerializer uses to override the default way it serializes a class.

C# Syntax:


        public class XmlElementAttributes : CollectionBase

Remarks

The XmlElementAttributes is returned by the XmlAttributes.XmlElements property of the XmlAttributes class. By using the XmlAttributeOverrides class and the XmlAttributes class, you can override the default way that the XmlSerializer serializes a class.

Example

The following example serializes the


            Transportation

class, which contains a single field named


            Vehicles

that returns an ArrayList. The example first applies two instances of the XmlElementAttribute class to the


            Vehicles

field that specify the types of objects the XmlSerializer can insert into the array. The example then creates two XmlElementAttribute objects to override the behavior of the attributes applied to the Vehicles property. The two overriding objects are added to the XmlElementAttributes collection of an XmlAttributes. Lastly, the example adds the XmlAttributes to an XmlAttributeOverrides, allowing the XmlSerializer to insert the new object types into the ArrayList returned by the


            Vehicles

field.

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

public class Transportation
{
   // Override these two XmlElementAttributes.
   [XmlElement(typeof(Car)),
   XmlElement(typeof(Plane))]
   public ArrayList Vehicles;
}

public class Car
{
   public string Name;
}

public class Plane
{
   public string Name;
}

public class Truck
{
   public string Name;
}

public class Train
{
   public string Name;
}

public class Test
{
   public static void Main()
   {
      Test t = new Test();
      t.SerializeObject("OverrideElement.xml");
   }

   public XmlSerializer CreateOverrider()
   {
      // Create XmlAtrributes and XmlAttributeOverrides instances. 
   
      XmlAttributes attrs = new XmlAttributes();

      XmlAttributeOverrides xOver = 
      new XmlAttributeOverrides();
      
      /* Create an XmlElementAttributes object to override 
      one of the attributes applied to the Vehicles property. */
      XmlElementAttribute xElement1 = 
      new XmlElementAttribute(typeof(Truck));
      // Add the XmlElementAttribute to the collection.
      attrs.XmlElements.Add(xElement1);

      /* Create a second XmlElementAttribute and 
      add it to the collection. */
      XmlElementAttribute xElement2 = 
      new XmlElementAttribute(typeof(Train));
      attrs.XmlElements.Add(xElement2);

      /* Add the XmlAttributes to the XmlAttributeOverrides,
      specifying the member to override. */
      xOver.Add(typeof(Transportation), "Vehicles", attrs);
      
      // Create the XmlSerializer, and return it.
      XmlSerializer xSer = new XmlSerializer
      (typeof(Transportation), xOver);
      return xSer;
   }

   public void SerializeObject(string filename)
   {
      // Create an XmlSerializer instance.
      XmlSerializer xSer = CreateOverrider();

      // Create the object.
      Transportation myTransportation = 
      new Transportation();

      /* Create two new, overriding objects that can be
      inserted into the Vehicles array. */
      myTransportation.Vehicles = new ArrayList();
      Truck myTruck = new Truck();
      myTruck.Name = "MyTruck";

      Train myTrain = new Train();
      myTrain.Name = "MyTrain";

      myTransportation.Vehicles.Add(myTruck);
      myTransportation.Vehicles.Add(myTrain);

      TextWriter writer = new StreamWriter(filename);
      xSer.Serialize(writer, myTransportation);
   }
}

See also:

System.Xml.Serialization Namespace

System.Xml.Serialization.XmlElementAttributes Member List:

Public Constructors

ctor #1

Default constructor. This constructor is called by derived class constructors to initialize state in this type.

Public Properties

Count (inherited from System.Collections.CollectionBase)	Read-only See base class member description: System.Collections.CollectionBase.Count Gets the number of elements contained in the CollectionBase instance.
Item	Read-write Gets or sets an XmlElementAttribute from the collection.

Public Methods

Add	Adds an XmlElementAttribute to the collection.
Clear (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.Clear Removes all objects from the CollectionBase instance.
Contains	Gets a value that specifies whether the collections contains the specified object.
CopyTo	Copies the XmlElementAttributes, or a portion of it to a one-dimensional array.
Equals (inherited from System.Object)	See base class member description: System.Object.Equals Derived from System.Object, the primary base class for all objects.
GetEnumerator (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.GetEnumerator Returns an enumerator that can iterate through the CollectionBase instance.
GetHashCode (inherited from System.Object)	See base class member description: System.Object.GetHashCode Derived from System.Object, the primary base class for all objects.
GetType (inherited from System.Object)	See base class member description: System.Object.GetType Derived from System.Object, the primary base class for all objects.
IndexOf	Gets the index of the specified XmlElementAttribute.
Insert	Inserts an XmlElementAttribute into the collection.
Remove	Removes the specified object from the collection.
RemoveAt (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.RemoveAt Removes the element at the specified index of the CollectionBase instance.
ToString (inherited from System.Object)	See base class member description: System.Object.ToString Derived from System.Object, the primary base class for all objects.

Protected Properties

InnerList (inherited from System.Collections.CollectionBase)	Read-only See base class member description: System.Collections.CollectionBase.InnerList Gets an ArrayList containing the list of elements in the CollectionBase instance.
List (inherited from System.Collections.CollectionBase)	Read-only See base class member description: System.Collections.CollectionBase.List Gets an IList containing the list of elements in the CollectionBase instance.

Protected Methods

Finalize (inherited from System.Object)	See base class member description: System.Object.Finalize Derived from System.Object, the primary base class for all objects.
MemberwiseClone (inherited from System.Object)	See base class member description: System.Object.MemberwiseClone Derived from System.Object, the primary base class for all objects.
OnClear (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnClear Performs additional custom processes when clearing the contents of the CollectionBase instance.
OnClearComplete (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnClearComplete Performs additional custom processes after clearing the contents of the CollectionBase instance.
OnInsert (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnInsert Performs additional custom processes before inserting a new element into the CollectionBase instance.
OnInsertComplete (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnInsertComplete Performs additional custom processes after inserting a new element into the CollectionBase instance.
OnRemove (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnRemove Performs additional custom processes when removing an element from the CollectionBase instance.
OnRemoveComplete (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnRemoveComplete Performs additional custom processes after removing an element from the CollectionBase instance.
OnSet (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnSet Performs additional custom processes before setting a value in the CollectionBase instance.
OnSetComplete (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnSetComplete Performs additional custom processes after setting a value in the CollectionBase instance.
OnValidate (inherited from System.Collections.CollectionBase)	See base class member description: System.Collections.CollectionBase.OnValidate Performs additional custom processes when validating a value.

Hierarchy:

System.Object

System.Collections.CollectionBase

System.Xml.Serialization.XmlElementAttributes

System.Xml.Serialization.XmlElementAttributes Member Details

ctor #1

Summary:: Default constructor. This constructor is called by derived class constructors to initialize state in this type.

C# Syntax:


            public XmlElementAttributes();