IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) Method

Definition

Konvertiert ein Objekt in seine XML-Darstellung.Converts an object into its XML representation.

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 XmlWriter XmlWriter XmlWriter

Der XmlWriter-Stream, in den das Objekt serialisiert wird.The XmlWriter stream to which the object is serialized.

Beispiele

Das folgende Beispiel zeigt eine Implementierung der WriteXml Methode.The following example illustrates an implementation of the WriteXml method.

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

Das folgende Beispiel veranschaulicht die Verwendung der XmlSerializer Klasse zum Deserialisieren dieses Objekts.The following example illustrates the use of the XmlSerializer class to deserialize this object.

#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 Implementierung, die Sie bereitstellen, sollte die XML-Darstellung des Objekts schreiben.The WriteXml implementation you provide should write out the XML representation of the object. Das Framework schreibt ein Wrapperelement und den XML-Writer positioniert, nach dessen Start.The framework writes a wrapper element and positions the XML writer after its start. Eine Implementierung kann seinen Inhalt, einschließlich der untergeordneten Elemente zu schreiben.Your implementation may write its contents, including child elements. Das Framework schließt dann das Wrapperelement.The framework then closes the wrapper element.

Schreiben Sie ausreichende Informationen, die XmlWriter Stream, damit die ReadXml Methode, um das Objekt wieder zusammenzusetzen.Write sufficient information to the XmlWriter stream to allow the ReadXml method to reconstitute your object.

Wenn Ihre Objektzustand eine Array-Variable enthält, z. B. Achten Sie darauf, dass Sie die Länge des Arrays zu schreiben, oder verwenden Sie ein übergeordnetes Element, um die Elemente enthalten, die die Arraywerte beschreiben, damit Sie wissen, wie viele Werte zu lesen, wenn das Objekt wiederhergestellt wird.For example, if your object state includes an array variable, be sure to write the length of the array, or use a parent element to contain the elements that describe the array values, so that you know how many values to read when the object is reconstituted.

Gilt für: