IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) Method

Definizione

Converte un oggetto nella relativa rappresentazione XML.Converts an object into its XML representation.

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 XmlWriter XmlWriter XmlWriter

Flusso XmlWriter nel quale viene serializzato l'oggetto.The XmlWriter stream to which the object is serialized.

Esempi

L'esempio seguente illustra un'implementazione del WriteXml (metodo).The following example illustrates an implementation of the WriteXml method.

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

Nell'esempio seguente viene illustrato l'utilizzo del XmlSerializer classe da deserializzare questo oggetto.The following example illustrates the use of the XmlSerializer class to deserialize this object.

#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

Il WriteXml implementazione è fornire deve scrivere la rappresentazione XML dell'oggetto.The WriteXml implementation you provide should write out the XML representation of the object. Il framework scrive un elemento wrapper e posiziona il writer XML dopo l'avvio.The framework writes a wrapper element and positions the XML writer after its start. L'implementazione può scrivere il contenuto, inclusi gli elementi figlio.Your implementation may write its contents, including child elements. Il framework quindi lo chiude l'elemento wrapper.The framework then closes the wrapper element.

Scrivere informazioni sufficienti per il XmlWriter flusso per consentire il ReadXml metodo per ricostituire l'oggetto.Write sufficient information to the XmlWriter stream to allow the ReadXml method to reconstitute your object.

Ad esempio, se lo stato dell'oggetto include una variabile di matrice, assicurarsi di scrivere la lunghezza della matrice o usare un elemento padre per contenere gli elementi che descrivono i valori della matrice, in modo che si conosce il numero di valori per la lettura quando l'oggetto viene ricostituito.For example, if your object state includes an array variable, be sure to write the length of the array, or use a parent element to contain the elements that describe the array values, so that you know how many values to read when the object is reconstituted.

Si applica a