IXmlSerializable.WriteXml(XmlWriter) Methode
Definition
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.
Konvertiert ein Objekt in die XML-Darstellung.
public:
void WriteXml(System::Xml::XmlWriter ^ writer);public void WriteXml(System.Xml.XmlWriter writer);abstract member WriteXml : System.Xml.XmlWriter -> unitPublic Sub WriteXml (writer As XmlWriter)Parameter
Beispiele
Im folgenden Beispiel wird eine Implementierung der WriteXml Methode veranschaulicht.
public void WriteXml (XmlWriter writer)
{
writer.WriteString(personName);
}
Das folgende Beispiel veranschaulicht die Verwendung der XmlSerializer Klasse zum Serialisieren dieses Objekts.
using System;
using System.Xml;
using System.Xml.Serialization;
public class Writer {
public static void Main() {
// Create a person object.
Person fred = new Person("Fred Flintstone");
// Serialize the object to a file.
XmlTextWriter writer = new XmlTextWriter("test.xml", null);
XmlSerializer serializer = new XmlSerializer(typeof(Person));
serializer.Serialize(writer, fred);
}
}
Hinweise
Die WriteXml von Ihnen bereitgestellte Implementierung sollte die XML-Darstellung des Objekts herausschreiben. Das Framework schreibt ein Wrapperelement und positioniert den XML-Writer nach dem Start. Ihre Implementierung schreibt möglicherweise den Inhalt, einschließlich untergeordneter Elemente. Das Framework schließt dann das Wrapperelement.
Schreiben Sie ausreichende Informationen in den XmlWriter Datenstrom, damit die ReadXml Methode Ihr Objekt neu konstituieren kann.
Wenn ihr Objektzustand beispielsweise eine Arrayvariable enthält, müssen Sie unbedingt die Länge des Arrays schreiben oder ein übergeordnetes Element verwenden, um die Elemente zu enthalten, die die Arraywerte beschreiben, damit Sie wissen, wie viele Werte gelesen werden sollen, wenn das Objekt wiederhergestellt wird.
