Класс System::Xml::XmlTextWriter

XmlTextWriter class

Представляет записывающий объект, обеспечивающий быстрый, некешированный последовательный способ генерации потоков или файлов, содержащих XML‑данные, соответствующие рекомендациям W3C Extensible Markup Language (XML) 1.0 и Namespaces in XML.

class XmlTextWriter : public System::Xml::XmlWriter

Методы

МетодОписание
Close() overrideЗакрывает этот поток и базовый поток.
Flush() overrideСбрасывает всё, что находится в буфере, в базовые потоки, а также сбрасывает базовый поток.
get_BaseStream()Возвращает объект базового потока.
get_Formatting()Указывает, как форматируется вывод.
get_Indentation()Возвращает, сколько символов IndentChars следует записывать для каждого уровня иерархии, когда XmlTextWriter::set_Formatting установлен в Formatting::Indented.
get_IndentChar()Возвращает, какой символ использовать для отступов, когда XmlTextWriter::set_Formatting установлен в Formatting::Indented.
get_Namespaces()Возвращает значение, указывающее, следует ли поддерживать пространства имён.
get_QuoteChar()Возвращает, какой символ использовать для кавычек значений атрибутов.
get_WriteState() overrideВозвращает состояние писателя.
get_XmlLang() overrideВозвращает текущую область xml:lang.
get_XmlSpace() overrideВозвращает объект XmlSpace, представляющий текущую область xml:space.
LookupPrefix(String) overrideВозвращает ближайший префикс, определённый в текущей области пространства имён для URI пространства имён.
set_Formatting(System::Xml::Formatting)Указывает, как форматируется вывод.
set_Indentation(int32_t)Устанавливает, сколько символов IndentChars следует записывать для каждого уровня иерархии, когда XmlTextWriter::set_Formatting установлен в Formatting::Indented.
set_IndentChar(char16_t)Устанавливает, какой символ использовать для отступов, когда XmlTextWriter::set_Formatting установлен в Formatting::Indented.
set_Namespaces(bool)Устанавливает значение, указывающее, следует ли поддерживать пространства имён.
set_QuoteChar(char16_t)Устанавливает, какой символ использовать для кавычек значений атрибутов.
WriteBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideКодирует указанные двоичные байты в base64 и записывает полученный текст.
WriteBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideКодирует указанные двоичные байты в binhex и записывает полученный текст.
WriteCData(String) overrideЗаписывает блок , содержащий указанный текст.
WriteCharEntity(char16_t) overrideПринудительно генерирует символьную сущность для указанного значения Unicode‑символа.
WriteChars(ArrayPtr<char16_t>, int32_t, int32_t) overrideЗаписывает текст буфер за буфером.
WriteComment(String) overrideЗаписывает комментарий ****, содержащий указанный текст.
WriteDocType(const String&, const String&, const String&, const String&) overrideЗаписывает объявление DOCTYPE с указанным именем и необязательными атрибутами.
WriteEndAttribute() overrideЗакрывает предыдущий вызов XmlTextWriter::WriteStartAttribute.
WriteEndDocument() overrideЗакрывает любые открытые элементы или атрибуты и возвращает писатель в состояние Start.
WriteEndElement() overrideЗакрывает один элемент и снимает соответствующую область пространства имён.
WriteEntityRef(const String&) overrideЗаписывает ссылку на сущность как &name;.
WriteFullEndElement() overrideЗакрывает один элемент и снимает соответствующую область пространства имён.
WriteName(const String&) overrideЗаписывает указанное имя, гарантируя, что оно является допустимым именем согласно рекомендации W3C XML 1.0.
WriteNmToken(const String&) overrideЗаписывает указанное имя, гарантируя, что оно является действительным NmToken согласно рекомендации W3C XML 1.0.
WriteProcessingInstruction(String, String) overrideЗаписывает инструкцию обработки с пробелом между именем и текстом следующим образом: .
WriteQualifiedName(const String&, const String&) overrideЗаписывает имя, квалифицированное пространством имён. Этот метод ищет префикс, находящийся в области видимости для данного пространства имён.
WriteRaw(ArrayPtr<char16_t>, int32_t, int32_t) overrideЗаписывает необработанную разметку вручную из буфера символов.
WriteRaw(const String&) overrideЗаписывает необработанную разметку вручную из строки.
WriteStartAttribute(const String&, const String&, const String&) overrideЗаписывает начало атрибута.
WriteStartDocument() overrideЗаписывает объявление XML с версией “1.0”.
WriteStartDocument(bool) overrideЗаписывает объявление XML с версией “1.0” и атрибутом standalone.
WriteStartElement(const String&, const String&, const String&) overrideЗаписывает указанный открывающий тег и связывает его с заданным пространством имён и префиксом.
WriteString(const String&) overrideЗаписывает предоставленное текстовое содержимое.
WriteSurrogateCharEntity(char16_t, char16_t) overrideГенерирует и записывает сущность суррогатного символа для пары суррогатных символов.
WriteWhitespace(String) overrideЗаписывает указанные пробельные символы.
XmlTextWriter(const SharedPtr<IO::Stream>&, const SharedPtr<Text::Encoding>&)Создаёт экземпляр класса XmlTextWriter, используя указанный поток и кодировку.
XmlTextWriter(const String&, const SharedPtr<Text::Encoding>&)Создаёт экземпляр класса XmlTextWriter, используя указанный файл.
XmlTextWriter(const SharedPtr<IO::TextWriter>&)Создаёт экземпляр класса XmlTextWriter, используя указанный TextWriter.

Typedefs

Определение типаОписание
PtrПсевдоним для shared pointer к экземпляру этого класса.

Примечания

Рекомендуется вместо этого использовать класс XmlWriter.

Объекты этого класса должны выделяться только с помощью функции System::MakeObject(). Никогда не создавайте экземпляры этого типа в стеке или с помощью оператора new, так как это приведёт к ошибкам времени выполнения и/или сбоям утверждений. Всегда оборачивайте этот класс в указатель System::SmartPtr и используйте этот указатель для передачи его в функции в качестве аргумента.

См. также