IXmlSerializable.WriteXml(XmlWriter) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Converteert een object naar de XML-weergave.
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)
Parameters
Voorbeelden
In het volgende voorbeeld ziet u een implementatie van de WriteXml methode.
public void WriteXml (XmlWriter writer)
{
writer.WriteString(personName);
}
In het volgende voorbeeld ziet u het gebruik van de XmlSerializer klasse om dit object te serialiseren.
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);
}
}
Opmerkingen
De WriteXml implementatie die u opgeeft, moet de XML-weergave van het object uitschrijven. Het framework schrijft een wrapper-element en plaatst de XML-schrijver na het begin. Uw implementatie kan de inhoud schrijven, inclusief onderliggende elementen. Het framework sluit vervolgens het wrapper-element.
Schrijf voldoende informatie naar de XmlWriter stream zodat de ReadXml methode uw object kan reconstitueren.
Als de objectstatus bijvoorbeeld een matrixvariabele bevat, moet u de lengte van de matrix schrijven of een bovenliggend element gebruiken om de elementen te bevatten die de matrixwaarden beschrijven, zodat u weet hoeveel waarden moeten worden gelezen wanneer het object opnieuw is samengesteld.