System::Xml::XmlWriterSettings класс

XmlWriterSettings class

Задает набор функций, поддерживаемых объектом XmlWriter, созданным методом XmlWriter::Create.

class XmlWriterSettings : public System::Object

Методы

МетодОписание
Clone()Создаёт копию экземпляра XmlWriterSettings.
get_CheckCharacters()Возвращает значение, указывающее, должен ли XML writer проверять, что все символы в документе соответствуют разделу “2.2 Characters” рекомендации W3C XML 1.0 Recommendation.
get_CloseOutput()Возвращает значение, указывающее, должен ли XmlWriter также закрывать базовый поток или TextWriter при вызове метода XmlWriter::Close.
get_ConformanceLevel()Возвращает уровень соответствия, который проверяет XML‑writer при выводе XML.
get_DoNotEscapeUriAttributes()Возвращает значение, указывающее, не экранирует ли XmlWriter атрибуты URI.
get_Encoding()Возвращает тип используемой текстовой кодировки.
get_Indent()Возвращает значение, указывающее, следует ли делать отступы элементов.
get_IndentChars()Возвращает строку символов, используемую для отступов. Этот параметр применяется, когда значение XmlWriterSettings::set_Indent установлено в true.
get_NamespaceHandling()Возвращает значение, указывающее, должен ли XmlWriter удалять дублирующие объявления пространств имён при записи XML‑содержимого. Поведение по умолчанию заключается в том, что writer выводит все объявления пространств имён, присутствующие в его разрешателе пространств имён.
get_NewLineChars()Возвращает строку символов, используемую для разрывов строк.
get_NewLineHandling()Возвращает значение, указывающее, следует ли нормализовать разрывы строк в выводе.
get_NewLineOnAttributes()Возвращает значение, указывающее, следует ли записывать атрибуты на новой строке.
get_OmitXmlDeclaration()Возвращает значение, указывающее, следует ли опустить объявление XML.
get_OutputMethod()Возвращает метод, используемый для сериализации вывода XmlWriter.
get_WriteEndDocumentOnClose()Возвращает значение, указывающее, будет ли XmlWriter добавлять закрывающие теги ко всем незакрытым тегам элементов при вызове метода XmlWriter::Close.
Reset()Сбрасывает члены класса настроек к их значениям по умолчанию.
set_CheckCharacters(bool)Устанавливает значение, указывающее, должен ли XML‑писатель проверять, что все символы в документе соответствуют разделу “2.2 Characters” W3C XML 1.0 Recommendation.
set_CloseOutput(bool)Устанавливает значение, указывающее, должен ли XmlWriter также закрывать базовый поток или TextWriter при вызове метода XmlWriter::Close.
set_ConformanceLevel(System::Xml::ConformanceLevel)Устанавливает уровень соответствия, который XML‑писатель проверяет в выводе XML.
set_DoNotEscapeUriAttributes(bool)Устанавливает значение, указывающее, не экранирует ли XmlWriter атрибуты URI.
set_Encoding(const SharedPtr<System::Text::Encoding>&)Устанавливает тип используемой текстовой кодировки.
set_Indent(bool)Устанавливает значение, указывающее, следует ли делать отступы у элементов.
set_IndentChars(const String&)Устанавливает строку символов, используемую при отступе. Этот параметр используется, когда значение XmlWriterSettings::set_Indent установлено в true.
set_NamespaceHandling(System::Xml::NamespaceHandling)Устанавливает значение, указывающее, должен ли XmlWriter удалять дублирующие объявления пространств имён при записи XML‑содержимого. Поведение по умолчанию: писатель выводит все объявления пространств имён, присутствующие в его разрешателе пространств имён.
set_NewLineChars(const String&)Устанавливает строку символов, используемую для разрывов строк.
set_NewLineHandling(System::Xml::NewLineHandling)Устанавливает значение, указывающее, следует ли нормализовать разрывы строк в выводе.
set_NewLineOnAttributes(bool)Устанавливает значение, указывающее, следует ли записывать атрибуты на новой строке.
set_OmitXmlDeclaration(bool)Устанавливает значение, указывающее, следует ли опустить объявление XML.
set_WriteEndDocumentOnClose(bool)Устанавливает значение, указывающее, будет ли XmlWriter добавлять закрывающие теги ко всем незакрытым тегам элементов при вызове метода XmlWriter::Close.
XmlWriterSettings()Инициализирует новый экземпляр класса XmlWriterSettings.

Typedefs

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

Примечания

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

См. также