IXmlSerializable.WriteXml(XmlWriter) Metoda

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestawy:

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

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Konwertuje obiekt na jego reprezentację XML.

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 serializowany jest obiekt.

Przykłady

Poniższy przykład ilustruje implementację WriteXml metody .

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.

#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

W WriteXml podanej implementacji należy zapisać reprezentację XML obiektu. Struktura zapisuje element otoki i umieszcza składnik zapisywania XML po jego uruchomieniu. Implementacja może zapisywać jego zawartość, w tym elementy podrzędne. Następnie struktura zamyka element otoki.

Zapisz wystarczające informacje do strumienia XmlWriter , aby umożliwić metodzie ReadXml odtworzenie obiektu.

Jeśli na przykład stan obiektu zawiera zmienną tablicową, pamiętaj, aby zapisać długość tablicy lub użyć elementu nadrzędnego, aby zawierać elementy opisujące wartości tablicy, aby wiedzieć, ile wartości do odczytania podczas ponownego utworzenia obiektu.