XmlArrayItemAttribute.ElementName-Eigenschaft

Ruft den Namen des generierten XML-Elements ab oder legt diesen fest.

Namespace: System.Xml.Serialization
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Property ElementName As String
'Usage
Dim instance As XmlArrayItemAttribute
Dim value As String

value = instance.ElementName

instance.ElementName = value

public string ElementName { get; set; }

public:
property String^ ElementName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ElementName ()

/** @property */
public void set_ElementName (String value)

public function get ElementName () : String

public function set ElementName (value : String)

Eigenschaftenwert

Der Name des generierten XML-Elements. Der Standardwert ist der Memberbezeichner.

Hinweise

Geben Sie einen ElementName an, wenn sich der Name des generierten XML-Elements vom Bezeichner des Members unterscheiden soll.

Sie können denselben ElementName-Wert für mehrere Klassenmember festlegen, wenn das generierte XML-Dokument mithilfe von XML-Namespaces Member mit identischen Namen unterscheidet. Ausführliche Informationen darüber, wie Namespaces und Namen mit Präfixen im XML-Dokument verwendet werden, finden Sie unter der XmlSerializerNamespaces-Klasse.

Beispiel

Im folgenden Beispiel wird die ElementName-Eigenschaft für die Vehicle-Klasse und die Car-Klasse festgelegt. Dadurch werden die Namen der von XmlSerializer für diese Klassen generierten XML-Elemente geändert.

Public Class Transportation
    ' Specifies acceptable types and the ElementName generated
    '  for each object type. 
    <XmlArray("Vehicles"), _
     XmlArrayItem(GetType(Vehicle), ElementName := "Transport"), _
     XmlArrayItem(GetType(Car), ElementName := "Automobile")> _
    Public MyVehicles() As Vehicle
End Class

' By default, this class results in XML elements named "Vehicle". 
Public Class Vehicle
    Public id As String
End Class

' By default, this class results in XMl elements named "Car". 
Public Class Car
    Inherits Vehicle
    Public Maker As String
End Class

public class Transportation
{  
   [XmlArray("Vehicles")]
   /* Specifies acceptable types and the ElementName generated 
      for each object type. */
   [XmlArrayItem(typeof(Vehicle), ElementName = "Transport"), 
   XmlArrayItem(typeof(Car), ElementName = "Automobile")]
   public Vehicle[] MyVehicles;
}

// By default, this class results in XML elements named "Vehicle". 
public class Vehicle
{
   public string id;
}

// By default, this class results in XML elements named "Car". 
public class Car:Vehicle
{
   public string Maker;
}

// By default, this class results in XML elements named "Vehicle". 
public ref class Vehicle
{
public:
   String^ id;
};

// By default, this class results in XML elements named "Car". 
public ref class Car: public Vehicle
{
public:
   String^ Maker;
};

public ref class Transportation
{
public:

   /* Specifies acceptable types and the ElementName generated 
         for each object type. */

   [XmlArray("Vehicles")]
   [XmlArrayItem(Vehicle::typeid,ElementName="Transport"),
   XmlArrayItem(Car::typeid,ElementName="Automobile")]
   array<Vehicle^>^MyVehicles;
};

public class Transportation
{
    /** @attribute XmlArray("Vehicles")
     */
    /* Specifies acceptable types and the ElementName generated 
       for each object type. 
    */
    /** @attribute XmlArrayItem(Vehicle.class, ElementName = "Transport")
        @attribute XmlArrayItem(Car.class, ElementName = "Automobile")
     */
    public Vehicle myVehicles[];
} //Transportation

// By default, this class results in XML elements named "Vehicle". 
public class Vehicle
{
    public String id;
} //Vehicle

// By default, this class results in XML elements named "Car". 
public class Car extends Vehicle
{
    public String maker;
} //Car

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, 1.0

Siehe auch

Referenz

XmlArrayItemAttribute-Klasse
XmlArrayItemAttribute-Member
System.Xml.Serialization-Namespace