XmlTextWriter 类

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

Source:

XmlTextWriter.cs

表示一个编写器，该编写器提供快速、非缓存的、仅向前的方法来生成包含符合 W3C 可扩展标记语言 （XML） 1.0 和 XML 建议中的命名空间的 XML 数据的文件。

从 .NET Framework 2.0 开始，我们建议改用 XmlWriter 类。

public ref class XmlTextWriter : System::Xml::XmlWriter

public class XmlTextWriter : System.Xml.XmlWriter

type XmlTextWriter = class
    inherit XmlWriter

Public Class XmlTextWriter
Inherits XmlWriter

继承

Object

XmlWriter

XmlTextWriter

注解

有关此 API 的详细信息，请参阅 xmlTextWriter补充 API 备注。

构造函数

XmlTextWriter(Stream, Encoding)	使用指定的流和编码创建 XmlTextWriter 类的实例。
XmlTextWriter(String, Encoding)	使用指定的文件创建 XmlTextWriter 类的实例。
XmlTextWriter(TextWriter)	使用指定的 TextWriter创建 XmlTextWriter 类的实例。

属性

BaseStream	获取基础流对象。
Formatting	指示如何设置输出的格式。
Indentation	获取或设置当 Formatting 设置为 Formatting.Indented时，层次结构中每个级别要写入的 IndentChar 数。
IndentChar	获取或设置 Formatting 设置为 Formatting.Indented时用于缩进的字符。
Namespaces	获取或设置一个值，该值指示是否支持命名空间。
QuoteChar	获取或设置用于引用属性值的字符。
Settings	获取用于创建此 XmlWriter 实例的 XmlWriterSettings 对象。 (继承自 XmlWriter)
WriteState	获取编写器的状态。
XmlLang	获取当前 xml:lang 范围。
XmlSpace	获取表示当前 xml:space 范围的 XmlSpace。

方法

Close()	关闭此流和基础流。
Dispose()	释放 XmlWriter 类的当前实例使用的所有资源。 (继承自 XmlWriter)
Dispose(Boolean)	释放 XmlWriter 使用的非托管资源，并选择性地释放托管资源。 (继承自 XmlWriter)
DisposeAsync()	以异步方式执行与释放、释放或重置非托管资源关联的应用程序定义任务。 (继承自 XmlWriter)
DisposeAsyncCore()	以异步方式执行与释放、释放或重置托管资源关联的应用程序定义任务。 (继承自 XmlWriter)
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
Flush()	将缓冲区中的内容刷新到基础流，并刷新基础流。
FlushAsync()	将缓冲区中的内容异步刷新到基础流，并刷新基础流。 (继承自 XmlWriter)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
LookupPrefix(String)	返回在命名空间 URI 的当前命名空间范围中定义的最接近的前缀。
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)
WriteAttributes(XmlReader, Boolean)	在派生类中重写时，写出在 XmlReader当前位置找到的所有属性。 (继承自 XmlWriter)
WriteAttributesAsync(XmlReader, Boolean)	异步写出在 XmlReader当前位置找到的所有属性。 (继承自 XmlWriter)
WriteAttributeString(String, String)	在派生类中重写时，写出具有指定本地名称和值的属性。 (继承自 XmlWriter)
WriteAttributeString(String, String, String)	在派生类中重写时，写入具有指定本地名称、命名空间 URI 和值的属性。 (继承自 XmlWriter)
WriteAttributeString(String, String, String, String)	在派生类中重写时，写出具有指定前缀、本地名称、命名空间 URI 和值的属性。 (继承自 XmlWriter)
WriteAttributeStringAsync(String, String, String, String)	以异步方式写出具有指定前缀、本地名称、命名空间 URI 和值的属性。 (继承自 XmlWriter)
WriteBase64(Byte[], Int32, Int32)	将指定的二进制字节编码为 base64，并写出生成的文本。
WriteBase64Async(Byte[], Int32, Int32)	将指定的二进制字节异步编码为 Base64，并写出生成的文本。 (继承自 XmlWriter)
WriteBinHex(Byte[], Int32, Int32)	将指定的二进制字节编码为 binhex 并写出生成的文本。
WriteBinHexAsync(Byte[], Int32, Int32)	将指定的二进制字节异步编码为 BinHex，并写出生成的文本。 (继承自 XmlWriter)
WriteCData(String)	写出 <！[CDATA]。]包含指定文本的> 块。
WriteCDataAsync(String)	异步写出 <！[CDATA]。]包含指定文本的> 块。 (继承自 XmlWriter)
WriteCharEntity(Char)	强制为指定的 Unicode 字符值生成字符实体。
WriteCharEntityAsync(Char)	异步强制为指定的 Unicode 字符值生成字符实体。 (继承自 XmlWriter)
WriteChars(Char[], Int32, Int32)	一次写入一个缓冲区的文本。
WriteCharsAsync(Char[], Int32, Int32)	一次异步写入一个缓冲区的文本。 (继承自 XmlWriter)
WriteComment(String)	写出包含指定文本的注释 <!--...-->。
WriteCommentAsync(String)	异步写出包含指定文本的注释 <!--...-->。 (继承自 XmlWriter)
WriteDocType(String, String, String, String)	编写具有指定名称和可选属性的 DOCTYPE 声明。
WriteDocTypeAsync(String, String, String, String)	使用指定的名称和可选属性异步写入 DOCTYPE 声明。 (继承自 XmlWriter)
WriteElementString(String, String)	写入具有指定本地名称和值的元素。 (继承自 XmlWriter)
WriteElementString(String, String, String)	写入具有指定本地名称、命名空间 URI 和值的元素。 (继承自 XmlWriter)
WriteElementString(String, String, String, String)	写入具有指定前缀、本地名称、命名空间 URI 和值的元素。 (继承自 XmlWriter)
WriteElementStringAsync(String, String, String, String)	异步写入具有指定前缀、本地名称、命名空间 URI 和值的元素。 (继承自 XmlWriter)
WriteEndAttribute()	关闭上一个 WriteStartAttribute(String, String, String) 调用。
WriteEndAttributeAsync()	异步关闭上一个 WriteStartAttribute(String, String) 调用。 (继承自 XmlWriter)
WriteEndDocument()	关闭任何打开的元素或属性，并将编写器重新置于“开始”状态。
WriteEndDocumentAsync()	异步关闭任何打开的元素或属性，并将编写器重新置于“开始”状态。 (继承自 XmlWriter)
WriteEndElement()	关闭一个元素并弹出相应的命名空间范围。
WriteEndElementAsync()	异步关闭一个元素并弹出相应的命名空间范围。 (继承自 XmlWriter)
WriteEntityRef(String)	以 &name;的形式写出实体引用。
WriteEntityRefAsync(String)	以异步方式将实体引用写出为 &name;。 (继承自 XmlWriter)
WriteFullEndElement()	关闭一个元素并弹出相应的命名空间范围。
WriteFullEndElementAsync()	异步关闭一个元素并弹出相应的命名空间范围。 (继承自 XmlWriter)
WriteName(String)	写出指定的名称，确保它是一个有效的名称，根据 W3C XML 1.0 建议。
WriteNameAsync(String)	异步写出指定名称，确保它根据 W3C XML 1.0 建议（https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name）是有效的名称。 (继承自 XmlWriter)
WriteNmToken(String)	根据 W3C XML 1.0 建议写出指定的名称，确保它是有效的 NmToken。
WriteNmTokenAsync(String)	根据 W3C XML 1.0 建议（https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name），异步写出指定名称，确保它是有效的 NmToken。 (继承自 XmlWriter)
WriteNode(XmlReader, Boolean)	在派生类中重写时，将读取器的所有内容复制到编写器，并将读取器移动到下一个兄弟姐妹的开头。 (继承自 XmlWriter)
WriteNode(XPathNavigator, Boolean)	将 XPathNavigator 对象的所有内容复制到编写器。 XPathNavigator 的位置保持不变。 (继承自 XmlWriter)
WriteNodeAsync(XmlReader, Boolean)	将读取器的所有内容异步复制到编写器，并将读取器移动到下一个同级级的开头。 (继承自 XmlWriter)
WriteNodeAsync(XPathNavigator, Boolean)	将 XPathNavigator 对象中的所有内容异步复制到编写器。 XPathNavigator 的位置保持不变。 (继承自 XmlWriter)
WriteProcessingInstruction(String, String)	写出名称与文本之间的空格的处理指令，如下所示：<？name text？>。
WriteProcessingInstructionAsync(String, String)	异步写出名称与文本之间的空格的处理指令，如下所示：<？name text？>。 (继承自 XmlWriter)
WriteQualifiedName(String, String)	写出命名空间限定的名称。 此方法查找位于给定命名空间范围内的前缀。
WriteQualifiedNameAsync(String, String)	异步写出命名空间限定的名称。 此方法查找位于给定命名空间范围内的前缀。 (继承自 XmlWriter)
WriteRaw(Char[], Int32, Int32)	从字符缓冲区手动写入原始标记。
WriteRaw(String)	从字符串手动写入原始标记。
WriteRawAsync(Char[], Int32, Int32)	从字符缓冲区手动异步写入原始标记。 (继承自 XmlWriter)
WriteRawAsync(String)	从字符串中手动异步写入原始标记。 (继承自 XmlWriter)
WriteStartAttribute(String)	写入具有指定本地名称的属性的开头。 (继承自 XmlWriter)
WriteStartAttribute(String, String)	写入具有指定本地名称和命名空间 URI 的属性的开头。 (继承自 XmlWriter)
WriteStartAttribute(String, String, String)	写入属性的开头。
WriteStartAttributeAsync(String, String, String)	异步写入具有指定前缀、本地名称和命名空间 URI 的属性的开头。 (继承自 XmlWriter)
WriteStartDocument()	使用版本“1.0”编写 XML 声明。
WriteStartDocument(Boolean)	使用版本“1.0”和独立属性写入 XML 声明。
WriteStartDocumentAsync()	使用版本“1.0”异步写入 XML 声明。 (继承自 XmlWriter)
WriteStartDocumentAsync(Boolean)	使用版本“1.0”和独立属性异步写入 XML 声明。 (继承自 XmlWriter)
WriteStartElement(String)	在派生类中重写时，写出具有指定本地名称的起始标记。 (继承自 XmlWriter)
WriteStartElement(String, String)	在派生类中重写时，写入指定的开始标记并将其与给定命名空间相关联。 (继承自 XmlWriter)
WriteStartElement(String, String, String)	写入指定的开始标记，并将其与给定的命名空间和前缀相关联。
WriteStartElementAsync(String, String, String)	异步写入指定的开始标记，并将其与给定的命名空间和前缀相关联。 (继承自 XmlWriter)
WriteString(String)	写入给定的文本内容。
WriteStringAsync(String)	异步写入给定的文本内容。 (继承自 XmlWriter)
WriteSurrogateCharEntity(Char, Char)	生成并写入代理项字符对的代理项字符实体。
WriteSurrogateCharEntityAsync(Char, Char)	异步生成和写入代理项字符对的代理项字符实体。 (继承自 XmlWriter)
WriteValue(Boolean)	写入 Boolean 值。 (继承自 XmlWriter)
WriteValue(DateTime)	写入 DateTime 值。 (继承自 XmlWriter)
WriteValue(DateTimeOffset)	写入 DateTimeOffset 值。 (继承自 XmlWriter)
WriteValue(Decimal)	写入 Decimal 值。 (继承自 XmlWriter)
WriteValue(Double)	写入 Double 值。 (继承自 XmlWriter)
WriteValue(Int32)	写入 Int32 值。 (继承自 XmlWriter)
WriteValue(Int64)	写入 Int64 值。 (继承自 XmlWriter)
WriteValue(Object)	写入对象值。 (继承自 XmlWriter)
WriteValue(Single)	写入单精度浮点数。 (继承自 XmlWriter)
WriteValue(String)	写入 String 值。 (继承自 XmlWriter)
WriteWhitespace(String)	写出给定的空格。
WriteWhitespaceAsync(String)	异步写出给定的空格。 (继承自 XmlWriter)

扩展方法

ConfigureAwait(IAsyncDisposable, Boolean)

配置如何执行从异步可释放项返回的任务的 await。

另请参阅

• XML 文档和数据