XmlRootAttribute.ElementName Eigenschaft
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Namen des von der XmlSerializer-Methode bzw. der Serialize(TextWriter, Object)-Methode der Deserialize(Stream)-Klasse generierten bzw. erkannten XML-Elements ab, oder legt diesen fest.
public:
property System::String ^ ElementName { System::String ^ get(); void set(System::String ^ value); };C#
public string ElementName { get; set; }member this.ElementName : string with get, setPublic Property ElementName As StringDer Name des für eine XML-Dokumentinstanz generierten und erkannten XML-Stammelements. Der Standardwert ist der Name der serialisierten Klasse.
Im folgenden Beispiel wird eine Instanz der XmlRootAttribute Klasse erstellt und die ElementName Eigenschaft auf einen neuen Wert festgelegt. Das Objekt wird dann verwendet, um ein XmlAttributeOverrides Objekt zu erstellen, das zum Außerkraftsetzen der Serialisierung eines Objekts verwendet wird.
public:
void SerializeOrder( String^ filename )
{
// Create an XmlSerializer instance using the method below.
XmlSerializer^ myXmlSerializer = CreateOverrider();
// Create the object, and set its Name property.
Student^ myStudent = gcnew Student;
myStudent->Name = "Student class1";
// Serialize the class, and close the TextWriter.
TextWriter^ writer = gcnew StreamWriter( filename );
myXmlSerializer->Serialize( writer, myStudent );
writer->Close();
}
// Return an XmlSerializer to the root serialization.
XmlSerializer^ CreateOverrider()
{
// Create an XmlAttributes to the default root element.
XmlAttributes^ myXmlAttributes = gcnew XmlAttributes;
// Create an XmlRootAttribute and set its element name and namespace.
XmlRootAttribute^ myXmlRootAttribute = gcnew XmlRootAttribute;
myXmlRootAttribute->ElementName = "OverriddenRootElementName";
myXmlRootAttribute->Namespace = "http://www.microsoft.com";
// Set the XmlRoot property to the XmlRoot object.
myXmlAttributes->XmlRoot = myXmlRootAttribute;
XmlAttributeOverrides^ myXmlAttributeOverrides =
gcnew XmlAttributeOverrides;
// Add the XmlAttributes object to the XmlAttributeOverrides object.
myXmlAttributeOverrides->Add( Student::typeid, myXmlAttributes );
// Create the Serializer, and return it.
XmlSerializer^ myXmlSerializer = gcnew XmlSerializer(
Student::typeid, myXmlAttributeOverrides );
return myXmlSerializer;
}
C#
public void SerializeOrder(string filename)
{
// Create an XmlSerializer instance using the method below.
XmlSerializer myXmlSerializer = CreateOverrider();
// Create the object, and set its Name property.
Student myStudent = new Student();
myStudent.Name = "Student class1";
// Serialize the class, and close the TextWriter.
TextWriter writer = new StreamWriter(filename);
myXmlSerializer.Serialize(writer, myStudent);
writer.Close();
}
// Return an XmlSerializer to override the root serialization.
public XmlSerializer CreateOverrider()
{
// Create an XmlAttributes to override the default root element.
XmlAttributes myXmlAttributes = new XmlAttributes();
// Create an XmlRootAttribute and set its element name and namespace.
XmlRootAttribute myXmlRootAttribute = new XmlRootAttribute();
myXmlRootAttribute.ElementName = "OverriddenRootElementName";
myXmlRootAttribute.Namespace = "http://www.microsoft.com";
// Set the XmlRoot property to the XmlRoot object.
myXmlAttributes.XmlRoot = myXmlRootAttribute;
XmlAttributeOverrides myXmlAttributeOverrides =
new XmlAttributeOverrides();
/* Add the XmlAttributes object to the
XmlAttributeOverrides object. */
myXmlAttributeOverrides.Add(typeof(Student), myXmlAttributes);
// Create the Serializer, and return it.
XmlSerializer myXmlSerializer = new XmlSerializer
(typeof(Student), myXmlAttributeOverrides);
return myXmlSerializer;
}
Public Sub SerializeOrder(filename As String)
' Create an XmlSerializer instance using the method below.
Dim myXmlSerializer As XmlSerializer = CreateOverrider()
' Create the object, and set its Name property.
Dim myStudent As New Student()
myStudent.Name = "Student class1"
' Serialize the class, and close the TextWriter.
Dim writer = New StreamWriter(filename)
myXmlSerializer.Serialize(writer, myStudent)
writer.Close()
End Sub
' Return an XmlSerializer to override the root serialization.
Public Function CreateOverrider() As XmlSerializer
' Create an XmlAttributes to override the default root element.
Dim myXmlAttributes As New XmlAttributes()
' Create an XmlRootAttribute and set its element name and namespace.
Dim myXmlRootAttribute As New XmlRootAttribute()
myXmlRootAttribute.ElementName = "OverriddenRootElementName"
myXmlRootAttribute.Namespace = "http://www.microsoft.com"
' Set the XmlRoot property to the XmlRoot object.
myXmlAttributes.XmlRoot = myXmlRootAttribute
Dim myXmlAttributeOverrides As New XmlAttributeOverrides()
' Add the XmlAttributes object to the XmlAttributeOverrides object.
myXmlAttributeOverrides.Add(GetType(Student), myXmlAttributes)
' Create the Serializer, and return it.
Dim myXmlSerializer As New XmlSerializer(GetType(Student), myXmlAttributeOverrides)
Return myXmlSerializer
End Function
Geben Sie einen ElementName Namen des generierten XML-Elements an, um sich vom Klassennamen zu unterscheiden.
| Produkt | Versionen |
|---|---|
| .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 |