IXmlSerializable.WriteXml(XmlWriter) Metoda

Definicja

Konwertuje obiekt na reprezentację w formacie XML.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)

Parametry

writer
XmlWriter

Strumień XmlWriter , do którego jest serializowany obiekt.The XmlWriter stream to which the object is serialized.

Przykłady

Poniższy przykład ilustruje implementację WriteXml metody.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);
}

Poniższy przykład ilustruje użycie XmlSerializer klasy do deserializacji tego obiektu.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);
  }

}

Uwagi

Wprowadzona WriteXml implementacja powinna zanotować reprezentację XML obiektu.The WriteXml implementation you provide should write out the XML representation of the object. Struktura zapisuje element otoki i umieszcza składnik zapisywania XML po jego uruchomieniu.The framework writes a wrapper element and positions the XML writer after its start. Twoja implementacja może zapisywać zawartość, w tym elementy podrzędne.Your implementation may write its contents, including child elements. Następnie struktura zamknie element otoki.The framework then closes the wrapper element.

Zapisz wystarczające informacje w XmlWriter strumieniu, aby ReadXml umożliwić metodzie odtworzenia obiektu.Write sufficient information to the XmlWriter stream to allow the ReadXml method to reconstitute your object.

Na przykład, jeśli stan obiektu zawiera zmienną tablicową, pamiętaj, aby napisać długość tablicy lub użyć elementu nadrzędnego, aby zawierał elementy, które opisują wartości tablicowe, aby wiedzieć, ile wartości należy odczytać, gdy obiekt zostanie odtworzony.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.

Dotyczy