IXmlSerializable.WriteXml(XmlWriter) Methode

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

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

Beispiele

Im folgenden Beispiel wird eine Implementierung der WriteXml -Methode veranschaulicht.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 XmlSerializer der-Klasse, um dieses Objekt zu deserialisieren.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 Wrapper Element und positioniert den XML-Writer nach dessen Start.The framework writes a wrapper element and positions the XML writer after its start. Ihre-Implementierung kann ihren Inhalt, einschließlich untergeordneter Elemente, schreiben.Your implementation may write its contents, including child elements. Das Framework schließt dann das Wrapper Element.The framework then closes the wrapper element.

Schreiben Sie genügend Informationen in XmlWriter den Stream, damit ReadXml die Methode das Objekt wiederherstellen kann.Write sufficient information to the XmlWriter stream to allow the ReadXml method to reconstitute your object.

Wenn Ihr Objektzustand z. b. eine Array Variable enthält, achten Sie darauf, die Länge des Arrays zu schreiben, oder verwenden Sie ein übergeordnetes Element, um die Elemente zu enthalten, die die Array Werte beschreiben, sodass Sie wissen, wie viele Werte gelesen werden sollen, wenn das Objekt wieder hergestellt 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: