IXmlSerializable.WriteXml(XmlWriter) Metódus

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

IXmlSerializable.cs

Átalakítja az objektumot XML-reprezentációvá.

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)

Paraméterek

writer

XmlWriter

Az XmlWriter a stream, amelyhez az objektum szerializálva van.

Példák

Az alábbi példa a metódus implementálását szemlélteti WriteXml .

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

Az alábbi példa az osztálynak az XmlSerializer objektum szerializálására való használatát mutatja be.

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);
  }
}

Megjegyzések

A WriteXml megadott implementációnak ki kell írnia az objektum XML-ábrázolását. A keretrendszer egy burkolóelemet ír, és a kezdés után elhelyezi az XML-írót. Az implementáció megírhatja annak tartalmát, beleértve a gyermekelemeket is. A keretrendszer ezután bezárja a burkolóelemet.

Írjon elegendő információt a XmlWriter streambe, hogy lehetővé tegye a ReadXml metódusnak az objektum újbóli helyreállítását.

Ha például az objektumállapot tartalmaz egy tömbváltozót, mindenképpen írja meg a tömb hosszát, vagy használjon szülőelemet a tömbértékeket leíró elemeket tartalmazó elemekkel, hogy tudja, hány értéket kell olvasni az objektum újbóli létrehozásakor.