IXmlSerializable.WriteXml(XmlWriter) Méthode

Définition

Espace de noms:

System.Xml.Serialization

Assemblys:

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

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Convertit un objet en sa représentation 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)

Paramètres

writer

XmlWriter

Flux XmlWriter dans lequel l'objet est sérialisé.

Exemples

L’exemple suivant illustre une implémentation de la WriteXml méthode.

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

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

L’exemple suivant illustre l’utilisation de la XmlSerializer classe pour désérialiser cet objet.

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

Remarques

L’implémentation WriteXml que vous fournissez doit écrire la représentation XML de l’objet. L’infrastructure écrit un élément wrapper et positionne l’enregistreur XML après son début. Votre implémentation peut écrire son contenu, y compris les éléments enfants. L’infrastructure ferme ensuite l’élément wrapper.

Écrivez des informations suffisantes dans le XmlWriter flux pour permettre à la ReadXml méthode de reconstituer votre objet.

Par exemple, si votre état d’objet inclut une variable de tableau, veillez à écrire la longueur du tableau ou à utiliser un élément parent pour contenir les éléments qui décrivent les valeurs du tableau, de sorte que vous savez le nombre de valeurs à lire lorsque l’objet est reconsitué.