IXmlSerializable.WriteXml(XmlWriter) Metodo

Definizione

Spazio dei nomi:

System.Xml.Serialization

Assembly:

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

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Converte un oggetto nella relativa rappresentazione 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)

Parametri

writer

XmlWriter

Flusso XmlWriter in cui viene deserializzato l'oggetto.

Esempio

Nell'esempio seguente viene illustrata un'implementazione del WriteXml metodo .

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

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

Nell'esempio seguente viene illustrato l'uso della XmlSerializer classe per deserializzare questo oggetto.

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

Commenti

L'implementazione WriteXml specificata deve scrivere la rappresentazione XML dell'oggetto. Il framework scrive un elemento wrapper e posiziona il writer XML dopo l'inizio. L'implementazione può scrivere il relativo contenuto, inclusi gli elementi figlio. Il framework chiude quindi l'elemento wrapper.

Scrivere informazioni sufficienti nel XmlWriter flusso per consentire al metodo di ricostituire l'oggetto ReadXml .

Ad esempio, se lo stato dell'oggetto include una variabile di matrice, assicurarsi di scrivere la lunghezza della matrice o di usare un elemento padre per contenere gli elementi che descrivono i valori della matrice, in modo da conoscere il numero di valori da leggere quando l'oggetto viene ricostituto.