IXmlSerializable.WriteXml(XmlWriter) Methode

public:
 void WriteXml(System::Xml::XmlWriter ^ writer);

public void WriteXml(System.Xml.XmlWriter writer);

abstract member WriteXml : System.Xml.XmlWriter -> unit

Public 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.