IXmlSerializable.WriteXml(XmlWriter) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует объект в его XML-представление.
public:
void WriteXml(System::Xml::XmlWriter ^ writer);public void WriteXml(System.Xml.XmlWriter writer);abstract member WriteXml : System.Xml.XmlWriter -> unitPublic Sub WriteXml (writer As XmlWriter)Параметры
Примеры
В следующем примере показана реализация WriteXml метода.
public void WriteXml (XmlWriter writer)
{
writer.WriteString(personName);
}
В следующем примере показано использование XmlSerializer класса для сериализации этого объекта.
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);
}
}
Комментарии
Предоставляемая WriteXml реализация должна записывать XML-представление объекта. Платформа записывает элемент-оболочку и помещает модуль записи XML после запуска. Реализация может записывать его содержимое, включая дочерние элементы. Затем платформа закрывает элемент оболочки.
Запись достаточной информации в XmlWriter поток, чтобы разрешить ReadXml методу воссоздать объект.
Например, если состояние объекта содержит переменную массива, обязательно напишите длину массива или используйте родительский элемент, чтобы содержать элементы, описывающие значения массива, чтобы узнать, сколько значений следует считывать при повторном создании объекта.
