XmlArrayItemAttribute.ElementName Propriedade

Definição

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Origem:

XmlArrayItemAttribute.cs

Obtém ou define o nome do elemento XML gerado.

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

Valor da propriedade

String

O nome do elemento XML gerado. O padrão é o identificador do membro.

Exemplos

O exemplo a seguir define a ElementName propriedade para a Vehicle classe e Car , alterando assim os nomes dos elementos XML que o XmlSerializer gera para essas classes.

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

Comentários

Especifique um ElementName se você quiser que o nome do elemento XML gerado difere do identificador do membro.

Você poderá definir o mesmo ElementName valor como mais de um membro de classe se o documento XML gerado usar namespaces XML para distinguir entre membros nomeados de forma idêntica. Para obter detalhes sobre como usar namespaces e nomes prefixados no documento XML, consulte a XmlSerializerNamespaces classe .