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.

C#

public void WriteXml (System.Xml.XmlWriter writer);

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.

C#

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

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

C#

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é.

S’applique à