Класс 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 и используйте этот указатель для передачи его в функции в качестве аргумента.
См. также
- Class XmlWriter
- Namespace System::Xml
- Library Aspose.Font for C++