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

Nell'esempio seguente viene illustrata 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 della XmlSerializer classe per 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

L' WriteXml implementazione fornita 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 proprio contenuto, inclusi gli elementi figlio.Your implementation may write its contents, including child elements. Il Framework chiude quindi l'elemento wrapper.The framework then closes the wrapper element.

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

Se, ad esempio, lo stato dell'oggetto include una variabile di matrice, assicurarsi di scrivere la lunghezza della matrice o di utilizzare un elemento padre per contenere gli elementi che descrivono i valori della matrice, in modo da ottenere informazioni sul numero di valori da leggere 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