XmlArrayItemAttribute.ElementName Eigenschaft

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

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

public string ElementName { get; set; }

member this.ElementName : string with get, set

Public Property ElementName As String

Eigenschaftswert

String

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

Beispiele

Im folgenden Beispiel wird die ElementName Eigenschaft für die Vehicle und Car die Klasse festgelegt, wodurch die Namen von XML-Elementen geändert werden, die für XmlSerializer diese Klassen generiert werden.

// 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
{
   [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;
}

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

Hinweise

Geben Sie an ElementName , ob der Name des generierten XML-Elements vom Bezeichner des Elements abweichen soll.

Sie können denselben ElementName Wert auf mehrere Klassenmember festlegen, wenn das generierte XML-Dokument XML-Namespaces verwendet, um zwischen identisch benannten Elementen zu unterscheiden. Ausführliche Informationen zur Verwendung von Namespaces und präfixierten Namen im XML-Dokument finden Sie in der XmlSerializerNamespaces Klasse.