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

Definición

Convierte un objeto en su representación 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)

Parámetros

writer
XmlWriter XmlWriter XmlWriter XmlWriter

Secuencia XmlWriter a la que se serializa el objeto.The XmlWriter stream to which the object is serialized.

Ejemplos

En el ejemplo siguiente se muestra una implementación del WriteXml método.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);
}

En el ejemplo siguiente se muestra el uso de XmlSerializer la clase para deserializar este objeto.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);
  }

}

Comentarios

La WriteXml implementación que proporcione debe escribir la representación XML del objeto.The WriteXml implementation you provide should write out the XML representation of the object. El marco de trabajo escribe un elemento contenedor y coloca el escritor XML después de su inicio.The framework writes a wrapper element and positions the XML writer after its start. La implementación puede escribir su contenido, incluidos los elementos secundarios.Your implementation may write its contents, including child elements. A continuación, el marco de trabajo cierra el elemento contenedor.The framework then closes the wrapper element.

Escriba información suficiente en la XmlWriter secuencia para permitir que ReadXml el método reconstituya el objeto.Write sufficient information to the XmlWriter stream to allow the ReadXml method to reconstitute your object.

Por ejemplo, si el estado del objeto incluye una variable de matriz, asegúrese de escribir la longitud de la matriz o use un elemento primario para contener los elementos que describen los valores de la matriz, de modo que sepa cuántos valores leer cuando se reconstituye el objeto.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.

Se aplica a