XmlTextWriter 类

参考

定义

命名空间:: System.Xml

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

Source:: XmlTextWriter.cs

Source:: XmlTextWriter.cs

Source:: XmlTextWriter.cs

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示提供快速、非缓存、只进方法的写入器，该方法生成包含 XML 数据（这些数据符合 W3C 可扩展标记语言 (XML) 1.0 和“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)

显式接口实现

IDisposable.Dispose()

有关此成员的说明，请参见 Dispose()。

(继承自 XmlWriter)

扩展方法

ConfigureAwait(IAsyncDisposable, Boolean)

配置如何执行从异步可处置项返回的任务的等待。

适用于

另请参阅

XML 文档和数据

XmlTextWriter 类

定义

注解

构造函数

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

反馈

其他资源