System::Xml::XmlTextWriter 类
内容
[
隐藏
]XmlTextWriter class
表示一个写入器,提供一种快速、非缓存、仅向前的方式来生成符合 W3C 可扩展标记语言 (XML) 1.0 和 XML 命名空间推荐的包含 XML 数据的流或文件。
class XmlTextWriter : public System::Xml::XmlWriter
方法
| 方法 | 描述 |
|---|---|
| Close() override | 关闭此流以及底层流。 |
| Flush() override | 将缓冲区中的内容刷新到底层流,并同时刷新底层流。 |
| get_BaseStream() | 返回底层流对象。 |
| get_Formatting() | 指示输出的格式化方式。 |
| get_Indentation() | 当 XmlTextWriter::set_Formatting 设置为 Formatting::Indented 时,返回每个层级在层次结构中要写入的 IndentChars 数量。 |
| get_IndentChar() | 当 XmlTextWriter::set_Formatting 设置为 Formatting::Indented 时,返回用于缩进的字符。 |
| get_Namespaces() | 返回一个值,指示是否启用命名空间支持。 |
| get_QuoteChar() | 返回用于引用属性值的字符。 |
| get_WriteState() override | 返回写入器的状态。 |
| get_XmlLang() override | 返回当前的 xml:lang 范围。 |
| get_XmlSpace() override | 返回表示当前 xml:space 范围的 XmlSpace。 |
| LookupPrefix(String) override | 返回在当前命名空间作用域中为该命名空间 URI 定义的最近前缀。 |
| set_Formatting(System::Xml::Formatting) | 指示输出的格式化方式。 |
| set_Indentation(int32_t) | 当 XmlTextWriter::set_Formatting 设置为 Formatting::Indented 时,设置每个层级在层次结构中要写入的 IndentChars 数量。 |
| 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 recommendation 是有效名称。 |
| WriteNmToken(const String&) override | 写出指定的名称,确保它根据 W3C XML 1.0 recommendation 是有效的 NmToken。 |
| 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 | 写出版本为 “1.0” 的 XML 声明。 |
| WriteStartDocument(bool) override | 写出版本为 “1.0” 且包含 standalone 属性的 XML 声明。 |
| 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>&) | 使用指定的 TextWriter 创建 XmlTextWriter 类的实例。 |
Typedefs
| 类型定义 | 描述 |
|---|---|
| Ptr | 此类实例的共享指针别名。 |
备注
建议改用 XmlWriter 类。
此类的对象只能使用 System::MakeObject() 函数分配。切勿在栈上或使用 new 运算符创建此类型的实例,因为这会导致运行时错误和/或断言故障。始终将此类包装在 System::SmartPtr 指针中,并使用该指针将其作为参数传递给函数。
另见
- Class XmlWriter
- Namespace System::Xml
- Library Aspose.Page for C++