IXmlSerializable.WriteXml(XmlWriter) Método

Definición

Espacio de nombres:

System.Xml.Serialization

Ensamblados:

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

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

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

Parámetros

writer

XmlWriter

El flujo XmlWriter para el que se serializa el objeto.

Ejemplos

En el ejemplo siguiente se muestra una implementación del WriteXml método .

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 la XmlSerializer clase para deserializar este objeto.

#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. El marco escribe un elemento contenedor y coloca el escritor XML después de su inicio. La implementación puede escribir su contenido, incluidos los elementos secundarios. A continuación, el marco cierra el elemento contenedor.

Escriba suficiente información en la XmlWriter secuencia para permitir que el método reconstituya el ReadXml objeto.

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 se van a leer cuando se vuelva a constituir el objeto.