IXmlSerializable.WriteXml(XmlWriter) Methode

Definition

Namespace:

System.Xml.Serialization

Assemblys:

System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Konvertiert ein Objekt in dessen XML-Darstellung.

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

writer

XmlWriter

Der XmlWriter-Datenstrom, in den das Objekt serialisiert wird.

Beispiele

Im folgenden Beispiel wird eine Implementierung der WriteXml Methode veranschaulicht.

virtual void WriteXml( XmlWriter^ writer )
{
   writer->WriteString( personName );
}

public void WriteXml (XmlWriter writer)
{
    writer.WriteString(personName);
}

Im folgenden Beispiel wird die Verwendung der XmlSerializer Klasse veranschaulicht, um dieses Objekt zu deserialisieren.

#using <System.Xml.dll>
#using <System.dll>
#using <Person.dll>

using namespace System;
using namespace System::Xml;
using namespace System::Xml::Serialization;

int main()
{
   // Create a person object.
   Person ^ fred = gcnew Person( "Fred Flintstone" );

   // Serialize the object to a file.
   XmlTextWriter^ writer = gcnew XmlTextWriter( "test.xml", nullptr );
   XmlSerializer^ serializer = gcnew XmlSerializer( Person::typeid );
   serializer->Serialize( writer, fred );
}

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 ausschreiben. Das Framework schreibt ein Wrapperelement und positioniert den XML-Writer nach dem Start. Ihre Implementierung kann ihren Inhalt schreiben, einschließlich untergeordneter Elemente. Das Framework schließt dann das Wrapperelement.

Schreiben Sie genügend Informationen zum XmlWriter Stream, damit die ReadXml Methode Ihr Objekt neu konfigurieren kann.

Wenn ihr Objektzustand beispielsweise eine Arrayvariable enthält, müssen Sie die Länge des Arrays schreiben oder ein übergeordnetes Element verwenden, um die Elemente zu enthalten, die die Arraywerte beschreiben, sodass Sie wissen, wie viele Werte gelesen werden sollen, wenn das Objekt neu erstellt wird.