How to: Specify an Alternate Element Name for an XML Stream

Code Example

Using the XmlSerializer, you can generate more than one XML stream with the same set of classes. You might want to do this because two different XML Web services require the same basic information, with only slight differences. For example, imagine two XML Web services that process orders for books, and thus both require ISBN numbers. One service uses the tag <ISBN> while the second uses the tag <BookID>. You have a class named Book that contains a field named ISBN. When an instance of the Book class is serialized, it will, by default, use the member name (ISBN) as the tag element name. For the first XML Web service, this is as expected. But to send the XML stream to the second XML Web service, you must override the serialization so that the tag's element name is BookID.

To create an XML stream with an alternate element name

Create an instance of the xref:System.Xml.Serialization.XmlElementAttribute class.
Set the xref:System.Xml.Serialization.XmlElementAttribute.ElementName%2A of the xref:System.Xml.Serialization.XmlElementAttribute to "BookID".
Create an instance of the xref:System.Xml.Serialization.XmlAttributes class.
Add the XmlElementAttribute object to the collection accessed through the xref:System.Xml.Serialization.XmlAttributes.XmlElements%2A property of xref:System.Xml.Serialization.XmlAttributes .
Create an instance of the xref:System.Xml.Serialization.XmlAttributeOverrides class.
Add the XmlAttributes to the xref:System.Xml.Serialization.XmlAttributeOverrides, passing the type of the object to override and the name of the member being overridden.
Create an instance of the XmlSerializer class with XmlAttributeOverrides.
Create an instance of the Book class, and serialize or deserialize it.

Example

Public Class SerializeOverride()  
    ' Creates an XmlElementAttribute with the alternate name.  
    Dim myElementAttribute As XmlElementAttribute = _  
    New XmlElementAttribute()  
    myElementAttribute.ElementName = "BookID"  
    Dim myAttributes As XmlAttributes = New XmlAttributes()  
    myAttributes.XmlElements.Add(myElementAttribute)  
    Dim myOverrides As XmlAttributeOverrides = New XmlAttributeOverrides()  
    myOverrides.Add(typeof(Book), "ISBN", myAttributes)  
    Dim mySerializer As XmlSerializer = _  
    New XmlSerializer(GetType(Book), myOverrides)  
    Dim b As Book = New Book()  
    b.ISBN = "123456789"  
    ' Creates a StreamWriter to write the XML stream to.  
    Dim writer As StreamWriter = New StreamWriter("Book.xml")  
    mySerializer.Serialize(writer, b);  
End Class

public class SerializeOverride()  
{  
    // Creates an XmlElementAttribute with the alternate name.  
    XmlElementAttribute myElementAttribute = new XmlElementAttribute();  
    myElementAttribute.ElementName = "BookID";  
    XmlAttributes myAttributes = new XmlAttributes();  
    myAttributes.XmlElements.Add(myElementAttribute);  
    XmlAttributeOverrides myOverrides = new XmlAttributeOverrides();  
    myOverrides.Add(typeof(Book), "ISBN", myAttributes);  
    XmlSerializer mySerializer =   
    new XmlSerializer(typeof(Book), myOverrides)  
    Book b = new Book();  
    b.ISBN = "123456789"  
    // Creates a StreamWriter to write the XML stream to.  
    StreamWriter writer = new StreamWriter("Book.xml");  
    mySerializer.Serialize(writer, b);  
}

The XML stream might resemble the following.

<Book>  
    <BookID>123456789</BookID>  
</Book>

dotnet/docs

How to: Specify an Alternate Element Name for an XML Stream

To create an XML stream with an alternate element name

Example

See Also