XmlArrayItemAttribute.ElementName Свойство
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя созданного XML-элемента
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
Имя созданного XML-элемента. По умолчанию используется идентификатор члена
В следующем примере задается ElementName свойство для Vehicle
класса, Car
тем самым изменяя имена XML-элементов, создаваемых XmlSerializer для этих классов.
// 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
Укажите, ElementName если нужно, чтобы имя созданного XML-элемента отличалось от идентификатора элемента.
Одно и то же ElementName значение можно задать для нескольких членов класса, если созданный XML-документ использует пространства имен XML для различения идентичных именованных элементов. Дополнительные сведения об использовании пространств имен и имен с префиксом в XML-документе см. в XmlSerializerNamespaces этом классе.
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
.NET Standard | 2.0, 2.1 |
UWP | 10.0 |