XmlElementAttribute Constructor (String, Type)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Initializes a new instance of the XmlElementAttribute and specifies the name of the XML element and a derived type for the member to which the XmlElementAttribute is applied. This member type is used when the XmlSerializer serializes the object that contains it.
Namespace: System.Xml.Serialization
Assembly: System.Xml (in System.Xml.dll)
Syntax
'Declaration
Public Sub New ( _
elementName As String, _
type As Type _
)
public XmlElementAttribute(
string elementName,
Type type
)
Parameters
- elementName
Type: System.String
The XML element name of the serialized member.
- type
Type: System.Type
The Type of an object derived from the member's type.
Remarks
By default, the XmlSerializer uses the member name as the XML element name when serializing a class instance. For example, a field named Vehicle generates an XML element named Vehicle. However, if you need a different element, such as Cars, pass it in the elementName parameter.
Use the type parameter to specify a type that is derived from a base class. For example, suppose a property named MyAnimal returns an Animal object. You want to enhance the object, so you create a new class named Mammal that inherits from the Animal class. To instruct the XmlSerializer to accept the Mammal class when it serializes the MyAnimal property, pass the Type of the Mammal class to the constructor.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.