XmlTextReader 类

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

Source:

XmlTextReader.cs

表示提供对 XML 数据进行快速、非缓存、只进访问的读取器。

从 .NET Framework 2.0 开始，建议改用 XmlReader 类。

public ref class XmlTextReader : System::Xml::XmlReader, System::Xml::IXmlLineInfo, System::Xml::IXmlNamespaceResolver

public class XmlTextReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo, System.Xml.IXmlNamespaceResolver

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

继承

Object

XmlReader

XmlTextReader

实现

IXmlLineInfo IXmlNamespaceResolver

注解

有关此 API 的详细信息，请参阅 XmlTextReader 的补充 API 说明。

继承者说明

此类具有继承需求。 从 继承 XmlTextReader需要完全信任。

构造函数

XmlTextReader()	初始化 XmlTextReader 的新实例。
XmlTextReader(Stream)	使用指定的流初始化 XmlTextReader 类的新实例。
XmlTextReader(Stream, XmlNameTable)	用指定的流和 XmlNameTable 初始化 XmlTextReader 类的新实例。
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	用指定的流、XmlNodeType 和 XmlParserContext 初始化 XmlTextReader 类的新实例。
XmlTextReader(String)	用指定的文件初始化 XmlTextReader 类的新实例。
XmlTextReader(String, Stream)	使用指定的 URL 和流初始化 XmlTextReader 类的新实例。
XmlTextReader(String, Stream, XmlNameTable)	使用指定的 URL、流和 XmlNameTable 初始化 XmlTextReader 类的新实例。
XmlTextReader(String, TextReader)	使用指定的 URL 和 TextReader 初始化 XmlTextReader 类的新实例。
XmlTextReader(String, TextReader, XmlNameTable)	使用指定的 URL、TextReader 和 XmlNameTable 初始化 XmlTextReader 类的新实例。
XmlTextReader(String, XmlNameTable)	使用指定的文件和 XmlNameTable 初始化 XmlTextReader 类的新实例。
XmlTextReader(String, XmlNodeType, XmlParserContext)	使用指定的字符串、XmlNodeType 和 XmlParserContext 初始化 XmlTextReader 类的新实例。
XmlTextReader(TextReader)	使用指定的 XmlTextReader 初始化 TextReader 类的新实例。
XmlTextReader(TextReader, XmlNameTable)	使用指定的 XmlTextReader 和 TextReader 初始化 XmlNameTable 类的新实例。
XmlTextReader(XmlNameTable)	使用指定的 XmlTextReader 初始化 XmlNameTable 类的新实例。

属性

AttributeCount	获取当前节点上的属性数目。
BaseURI	获取当前节点的基 URI。
CanReadBinaryContent	获取一个值，该值指示 XmlTextReader 是否实现二进制内容读取方法。
CanReadValueChunk	获取一个值，该值指示 XmlTextReader 是否实现 ReadValueChunk(Char[], Int32, Int32) 方法。
CanResolveEntity	获取一个值，该值指示此读取器是否可以分析和解析实体。
Depth	获取 XML 文档中当前节点的深度。
DtdProcessing	获取或设置 DtdProcessing 枚举。
Encoding	获取文档的编码。
EntityHandling	获取或设置一个值，该值指定读取器处理实体的方式。
EOF	获取一个值，该值指示读取器是否定位在流结尾。
HasAttributes	获取一个值，该值指示当前节点是否有任何属性。 (继承自 XmlReader)
HasValue	获取一个值，该值指示当前节点是否可以具有 String.Empty 以外的 Value。
IsDefault	获取一个值，该值指示当前节点是否是从 DTD 或架构中定义的默认值生成的属性。
IsEmptyElement	获取一个值，该值指示当前节点是否为空元素， (例如 <MyElement/> ，) 。
Item[Int32]	当在派生类中被重写时，获取具有指定索引的属性的值。 (继承自 XmlReader)
Item[String, String]	当在派生类中被重写时，获取具有指定 LocalName 和 NamespaceURI 的属性的值。 (继承自 XmlReader)
Item[String]	当在派生类中被重写时，获取具有指定 Name 的属性的值。 (继承自 XmlReader)
LineNumber	获取当前行号。
LinePosition	获取当前行位置。
LocalName	获取当前节点的本地名称。
Name	获取当前节点的限定名称。
Namespaces	获取或设置一个值，该值指示是否进行命名空间支持。
NamespaceURI	获取读取器定位在的节点的命名空间 URI（采用 W3C 命名空间规范中定义）。
NameTable	获取与此实现关联的 XmlNameTable。
NodeType	获取当前节点的类型。
Normalization	获取或设置一个值，该值指示是否规范化空白区域和属性值。
Prefix	获取与当前节点关联的命名空间前缀。
ProhibitDtd	已过时. 获取或设置一个值，该值指示是否允许 DTD 处理。 此属性已过时。 请改用 DtdProcessing。
QuoteChar	获取用于括起属性节点的值的引号字符。
ReadState	获取读取器的状态。
SchemaInfo	获取作为架构验证结果分配给当前节点的架构信息。 (继承自 XmlReader)
Settings	获取用于创建此 XmlReader 实例的 XmlReaderSettings 对象。 (继承自 XmlReader)
Value	获取当前节点的文本值。
ValueType	获取当前节点的公共语言运行时 (CLR) 类型。 (继承自 XmlReader)
WhitespaceHandling	获取或设置一个值，该值指定如何处理空白区域。
XmlLang	获取当前 xml:lang 范围。
XmlResolver	设置用于解析 DTD 引用的 XmlResolver。
XmlSpace	获取当前 xml:space 范围。

方法

Close()	将 ReadState 改为 Closed。
Dispose()	释放 XmlReader 类的当前实例所使用的所有资源。 (继承自 XmlReader)
Dispose(Boolean)	释放由 XmlReader 占用的非托管资源，还可以另外再释放托管资源。 (继承自 XmlReader)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetAttribute(Int32)	获取具有指定索引的属性的值。
GetAttribute(String)	获取具有指定名称的属性的值。
GetAttribute(String, String)	获取具有指定本地名称和命名空间 URI 的属性的值。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetNamespacesInScope(XmlNamespaceScope)	获取一个集合，该集合包含当前在范围内的所有命名空间。
GetRemainder()	获取已缓冲的 XML 的剩余部分。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValueAsync()	异步获取当前节点的值。 (继承自 XmlReader)
HasLineInfo()	获取一个值，该值指示该类是否可返回行信息。
IsStartElement()	调用 MoveToContent() 并测试当前内容节点是否是开始标记或空元素标记。 (继承自 XmlReader)
IsStartElement(String)	调用 MoveToContent() 并测试当前内容节点是否是开始标记或空元素标记，以及所找到元素的 Name 属性是否与给定的参数匹配。 (继承自 XmlReader)
IsStartElement(String, String)	调用 MoveToContent() 并测试当前内容节点是否是开始标记或空元素标记，以及所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 (继承自 XmlReader)
LookupNamespace(String)	解析当前元素的范围内的命名空间前缀。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MoveToAttribute(Int32)	移动到具有指定索引的属性。
MoveToAttribute(String)	移动到具有指定名称的属性。
MoveToAttribute(String, String)	移动到具有指定本地名称和命名空间 URI 的属性。
MoveToContent()	检查当前节点是否是内容（非空白文本、CDATA、Element、EndElement、EntityReference 或 EndEntity）节点。 如果此节点不是内容节点，则读取器向前跳至下一个内容节点或文件结尾。 它跳过以下类型的节点：ProcessingInstruction、DocumentType、Comment、Whitespace 或 SignificantWhitespace。 (继承自 XmlReader)
MoveToContentAsync()	异步检查当前节点是否为内容节点。 如果此节点不是内容节点，则读取器向前跳至下一个内容节点或文件结尾。 (继承自 XmlReader)
MoveToElement()	移动到包含当前属性节点的元素。
MoveToFirstAttribute()	移动到第一个属性。
MoveToNextAttribute()	移动到下一个属性。
Read()	从流中读取下一个节点。
ReadAsync()	异步读取该流的下一个节点。 (继承自 XmlReader)
ReadAttributeValue()	将属性值分析为一个或多个 Text、EntityReference 或 EndEntity 节点。
ReadBase64(Byte[], Int32, Int32)	对 Base64 进行解码并返回解码的二进制字节。
ReadBinHex(Byte[], Int32, Int32)	对 BinHex 进行解码并返回解码后的二进制字节。
ReadChars(Char[], Int32, Int32)	将元素的文本内容读入字符缓冲区。 通过连续调用此方法，可以读取大的嵌入文本的流。
ReadContentAs(Type, IXmlNamespaceResolver)	将内容作为指定类型的对象读取。 (继承自 XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	将内容作为指定类型的对象异步读取。 (继承自 XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	读取内容并返回 Base64 解码的二进制字节。
ReadContentAsBase64Async(Byte[], Int32, Int32)	异步读取内容并返回 Base64 解码的二进制字节。 (继承自 XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	读取内容并返回 BinHex 解码的二进制字节。
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	异步读取内容并返回 BinHex 解码的二进制字节。 (继承自 XmlReader)
ReadContentAsBoolean()	将当前位置的文本内容作为 Boolean 读取。 (继承自 XmlReader)
ReadContentAsDateTime()	将当前位置的文本内容作为 DateTime 对象读取。 (继承自 XmlReader)
ReadContentAsDateTimeOffset()	将当前位置的文本内容作为 DateTimeOffset 对象读取。 (继承自 XmlReader)
ReadContentAsDecimal()	将当前位置的文本内容作为 Decimal 对象读取。 (继承自 XmlReader)
ReadContentAsDouble()	将当前位置的文本内容作为双精度浮点数读取。 (继承自 XmlReader)
ReadContentAsFloat()	将当前位置的文本内容作为单精度浮点数读取。 (继承自 XmlReader)
ReadContentAsInt()	将当前位置的文本内容作为 32 位有符号整数读取。 (继承自 XmlReader)
ReadContentAsLong()	将当前位置的文本内容作为 64 位有符号整数读取。 (继承自 XmlReader)
ReadContentAsObject()	将当前位置的文本内容作为 Object 读取。 (继承自 XmlReader)
ReadContentAsObjectAsync()	将当前位置的文本内容作为 Object 对象异步读取。 (继承自 XmlReader)
ReadContentAsString()	将当前位置的文本内容作为 String 对象读取。 (继承自 XmlReader)
ReadContentAsStringAsync()	将当前位置的文本内容作为 String 对象异步读取。 (继承自 XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	将元素内容作为请求类型读取。 (继承自 XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后将元素内容作为请求类型读取。 (继承自 XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	将元素内容作为请求类型异步读取。 (继承自 XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	读取元素并对 Base64 内容进行解码。
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	异步读取元素并对 Base64 内容进行解码。 (继承自 XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	读取元素并对 BinHex 内容进行解码。
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	异步读取元素并对 BinHex 内容进行解码。 (继承自 XmlReader)
ReadElementContentAsBoolean()	读取当前元素并将内容作为 Boolean 对象返回。 (继承自 XmlReader)
ReadElementContentAsBoolean(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Boolean 对象返回。 (继承自 XmlReader)
ReadElementContentAsDateTime()	读取当前元素并将内容作为 DateTime 对象返回。 (继承自 XmlReader)
ReadElementContentAsDateTime(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 DateTime 对象返回。 (继承自 XmlReader)
ReadElementContentAsDecimal()	读取当前元素并将内容作为 Decimal 对象返回。 (继承自 XmlReader)
ReadElementContentAsDecimal(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Decimal 对象返回。 (继承自 XmlReader)
ReadElementContentAsDouble()	读取当前元素并将内容作为双精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsDouble(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为双精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsFloat()	读取当前元素并将内容作为单精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsFloat(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为单精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsInt()	读取当前元素并将内容作为 32 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsInt(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 32 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsLong()	读取当前元素并将内容作为 64 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsLong(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 64 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsObject()	读取当前元素并将内容作为 Object 返回。 (继承自 XmlReader)
ReadElementContentAsObject(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Object 返回。 (继承自 XmlReader)
ReadElementContentAsObjectAsync()	异步读取当前元素并将内容作为 Object 返回。 (继承自 XmlReader)
ReadElementContentAsString()	读取当前元素并将内容作为 String 对象返回。 (继承自 XmlReader)
ReadElementContentAsString(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 String 对象返回。 (继承自 XmlReader)
ReadElementContentAsStringAsync()	异步读取当前元素并将内容作为 String 对象返回。 (继承自 XmlReader)
ReadElementString()	读取纯文本元素。 但是，建议改用 ReadElementContentAsString() 方法，因为该方法可以更直接地处理此操作。 (继承自 XmlReader)
ReadElementString(String)	在读取纯文本元素之前，检查所找到元素的 Name 属性是否与给定的字符串匹配。 但是，建议改用 ReadElementContentAsString() 方法，因为该方法可以更直接地处理此操作。 (继承自 XmlReader)
ReadElementString(String, String)	在读取纯文本元素之前，检查所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 但是，建议改用 ReadElementContentAsString(String, String) 方法，因为该方法可以更直接地处理此操作。 (继承自 XmlReader)
ReadEndElement()	检查当前内容节点是否为结束标记并将读取器推进到下一个节点。 (继承自 XmlReader)
ReadInnerXml()	当在派生类中被重写时，将所有内容（包括标记）当做字符串读取。 (继承自 XmlReader)
ReadInnerXmlAsync()	异步读取所有内容，包括作为字符串的标记。 (继承自 XmlReader)
ReadOuterXml()	当在派生类中被重写时，读取表示该节点和所有它的子级的内容（包括标记）。 (继承自 XmlReader)
ReadOuterXmlAsync()	异步读取包含该节点和所有它的子级的内容（包括标记）。 (继承自 XmlReader)
ReadStartElement()	检查当前节点是否为元素并将读取器推进到下一个节点。 (继承自 XmlReader)
ReadStartElement(String)	检查当前内容节点是否为具有给定 Name 的元素并将读取器推进到下一个节点。 (继承自 XmlReader)
ReadStartElement(String, String)	检查当前内容节点是否为具有给定 LocalName 和 NamespaceURI 的元素并将读取器推进到下一个节点。 (继承自 XmlReader)
ReadString()	将元素或文本节点的内容读取为一个字符串。
ReadSubtree()	返回新的 XmlReader 实例，此实例可用于读取当前节点及其所有子节点。 (继承自 XmlReader)
ReadToDescendant(String)	让 XmlReader 前进到下一个具有指定限定名的子代元素。 (继承自 XmlReader)
ReadToDescendant(String, String)	让 XmlReader 前进到下一个具有指定的本地名称和命名空间 URI 的子代元素。 (继承自 XmlReader)
ReadToFollowing(String)	一直读取，直到找到具有指定限定名的元素。 (继承自 XmlReader)
ReadToFollowing(String, String)	一直读取，直到找到具有指定的本地名称和命名空间 URI 的元素。 (继承自 XmlReader)
ReadToNextSibling(String)	让 XmlReader 前进到下一个具有指定限定名的同级元素。 (继承自 XmlReader)
ReadToNextSibling(String, String)	将 XmlReader 推进到具有指定的本地名称和命名空间 URI 的下一个同级元素。 (继承自 XmlReader)
ReadValueChunk(Char[], Int32, Int32)	读取嵌入在 XML 文档中的大量文本流。 (继承自 XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	异步读取嵌入在 XML 文档中的大量文本流。 (继承自 XmlReader)
ResetState()	将读取器的状态重置为 ReadState.Initial。
ResolveEntity()	解析 EntityReference 节点的实体引用。
Skip()	跳过当前节点的子级。
SkipAsync()	异步跳过当前节点的子级。 (继承自 XmlReader)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	有关此成员的说明，请参见 GetNamespacesInScope(XmlNamespaceScope)。
IXmlNamespaceResolver.LookupNamespace(String)	有关此成员的说明，请参见 LookupNamespace(String)。
IXmlNamespaceResolver.LookupPrefix(String)	有关此成员的说明，请参见 LookupPrefix(String)。

另请参阅

• XML 文档和数据