XmlArrayItemAttribute.ElementName Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

System.Xml.XmlSerializer.dll

Source:

XmlArrayItemAttribute.cs

Získá nebo nastaví název vygenerovaného xml elementu.

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

Hodnota vlastnosti

String

Název vygenerovaného elementu XML. Výchozí hodnota je identifikátor člena.

Příklady

Následující příklad nastaví ElementName vlastnost třídy Vehicle a Car a tím změní názvy elementů XML, které XmlSerializer generuje pro tyto třídy.

// 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

Poznámky

Zadejte, ElementName pokud chcete, aby se název vygenerovaného elementu XML lišil od identifikátoru člena.

Můžete nastavit stejnou ElementName hodnotu na více než jeden člen třídy, pokud vygenerovaný dokument XML používá obory názvů XML k rozlišení mezi identicky pojmenovanými členy. Podrobnosti o tom, jak používat obory názvů a názvy s předponami v dokumentu XML, najdete v XmlSerializerNamespaces třídě.