Поделиться через


Новые функции класса XmlWriter

В платформе Microsoft .NET Framework версии 2.0 в конструкцию и функциональность класса XmlWriter внесено много изменений.

Создание XmlWriter

Метод Create является рекомендованным механизмом для получения объектов XmlWriter. Метод Create использует класс XmlWriterSettings для указания возможностей, которые должен поддерживать экземпляр XmlWriter.

Дополнительные сведения см. в разделе Создание модуля записи XML.

Согласованность данных

Объекты XmlWriter, создаваемые методом Create по умолчанию более согласованы, чем реализация XmlTextWriter. Использование метода Create и класса XmlWriterSettings обеспечивает две дополнительные функции проверки соответствия.

Проверка символов

Свойство XmlWriterSettings.CheckCharacters настраивает объект XmlWriter для проверки символов в потоке XML-данных, чтобы гарантировать, что все символы находятся в диапазоне допустимых XML-символов. Проверка символов включает поиск недопустимых символов в текстовых узлах и XML-именах, а также проверку допустимости XML-имен (например, XML-имя не может начинаться с числа). Если XML-данные выходят за пределы диапазона допустимых XML-символов, возникает исключение XmlException.

Проверка согласованности

Свойство XmlWriterSettings.ConformanceLevel настраивает объект XmlWriter на проверку и гарантирует, что считываемый поток согласуется с определенным набором правил. В зависимости от указанного уровня согласованности, XML-данные можно проверять на соответствие правильному формату XML-документа 1.0 или его фрагмента. Если данные не согласованы, возникает исключение XmlException.

Дополнительные сведения см. в разделе Согласованность данных и XmlWriter.

Поддержка типов

Класс XmlWriter позволяет записывать значения как простые типизированные значения CLR.

Метод WriteValue можно использовать, чтобы передавать значения с помощью системных типов, а не строк. Благодаря этому значения можно записывать непосредственно, без необходимости преобразовывать значения вручную.

Дополнительные сведения см. в разделе Запись типизированных данных.

См. также

Другие ресурсы

Использование XmlWriter

XML-документы и данные