System.Xml.XmlNodeReader 类

方法描述

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

语法定义(C# System.Xml.XmlNodeReader 类 的用法)

public class XmlNodeReader : XmlReader, 
	IXmlNamespaceResolver

构造函数

构造函数名称 构造函数描述
XmlNodeReader 使用指定的 XmlNode 创建 XmlNodeReader 类的实例。

成员/方法

方法名称 方法描述
Close 将 ReadState 更改为 Closed。 (重写 XmlReader.Close()。)
Dispose(Boolean) 释放由 XmlReader 占用的非托管资源,还可以另外再释放托管资源。 (继承自 XmlReader。)
Equals(Object) 确定指定的 Object 是否等于当前的 Object。 (继承自 Object。)
Finalize 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。)
GetAttribute(Int32) 获取具有指定索引的特性的值。 (重写 XmlReader.GetAttribute(Int32)。)
GetAttribute(String) 获取具有指定名称的特性的值。 (重写 XmlReader.GetAttribute(String)。)
GetAttribute(String, String) 获取具有指定本地名称和命名空间 URI 的特性的值。 (重写 XmlReader.GetAttribute(String, String)。)
GetHashCode 用作特定类型的哈希函数。 (继承自 Object。)
GetType 获取当前实例的 Type。 (继承自 Object。)
IsStartElement() 调用 MoveToContent 并测试当前内容节点是否是开始标记或空元素标记。 (继承自 XmlReader。)
IsStartElement(String) 调用 MoveToContent 并测试当前内容节点是否是开始标记或空元素标记,以及所找到元素的 Name 属性是否与给定的参数匹配。 (继承自 XmlReader。)
IsStartElement(String, String) 调用 MoveToContent 并测试当前内容节点是否是开始标记或空元素标记,以及所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 (继承自 XmlReader。)
LookupNamespace 解析当前元素的范围内的命名空间前缀。 (重写 XmlReader.LookupNamespace(String)。)
MemberwiseClone 创建当前 Object 的浅表副本。 (继承自 Object。)
MoveToAttribute(Int32) 移动到具有指定索引的特性。 (重写 XmlReader.MoveToAttribute(Int32)。)
MoveToAttribute(String) 移动到具有指定名称的特性。 (重写 XmlReader.MoveToAttribute(String)。)
MoveToAttribute(String, String) 移动到具有指定本地名称和命名空间 URI 的特性。 (重写 XmlReader.MoveToAttribute(String, String)。)
MoveToContent 检查当前节点是否是内容(非空白文本、CDATA、Element、EndElement、EntityReference 或 EndEntity)节点。 如果此节点不是内容节点,则读取器向前跳至下一个内容节点或文件结尾。 它跳过以下类型的节点:ProcessingInstruction、DocumentType、Comment、Whitespace 或 SignificantWhitespace。 (继承自 XmlReader。)
MoveToElement 移动到包含当前特性节点的元素。 (重写 XmlReader.MoveToElement()。)
MoveToFirstAttribute 移动到第一个特性。 (重写 XmlReader.MoveToFirstAttribute()。)
MoveToNextAttribute 移动到下一个特性。 (重写 XmlReader.MoveToNextAttribute()。)
Read 从流中读取下一个节点。 (重写 XmlReader.Read()。)
ReadAttributeValue 将特性值分析为一个或多个 Text、EntityReference 或 EndEntity 节点。 (重写 XmlReader.ReadAttributeValue()。)
ReadContentAs 将内容作为指定类型的对象读取。 (继承自 XmlReader。)
ReadContentAsBase64 读取内容并返回 Base64 解码的二进制字节。 (重写 XmlReader.ReadContentAsBase64(Byte[], Int32, Int32)。)
ReadContentAsBinHex 读取内容并返回 BinHex 解码的二进制字节。 (重写 XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32)。)
ReadContentAsBoolean 将当前位置的文本内容作为 Boolean 读取。 (继承自 XmlReader。)
ReadContentAsDateTime 将当前位置的文本内容作为 DateTime 对象读取。 (继承自 XmlReader。)
ReadContentAsDecimal 将当前位置的文本内容作为 Decimal 对象读取。 (继承自 XmlReader。)
ReadContentAsDouble 将当前位置的文本内容作为双精度浮点数读取。 (继承自 XmlReader。)
ReadContentAsFloat 将当前位置的文本内容作为单精度浮点数读取。 (继承自 XmlReader。)
ReadContentAsInt 将当前位置的文本内容作为 32 位有符号整数读取。 (继承自 XmlReader。)
ReadContentAsLong 将当前位置的文本内容作为 64 位有符号整数读取。 (继承自 XmlReader。)
ReadContentAsObject 将当前位置的文本内容作为 Object 读取。 (继承自 XmlReader。)
ReadContentAsString 将当前位置的文本内容作为 String 对象读取。 (继承自 XmlReader。)
ReadElementContentAs(Type, IXmlNamespaceResolver) 将元素内容作为请求类型读取。 (继承自 XmlReader。)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) 检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配,然后将元素内容作为请求类型读取。 (继承自 XmlReader。)
ReadElementContentAsBase64 读取元素并对 Base64 内容进行解码。 (重写 XmlReader.ReadElementContentAsBase64(Byte[], Int32, Int32)。)
ReadElementContentAsBinHex 读取元素并对 BinHex 内容进行解码。 (重写 XmlReader.ReadElementContentAsBinHex(Byte[], Int32, Int32)。)
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。)
ReadElementContentAsString() 读取当前元素并将内容作为 String 对象返回。 (继承自 XmlReader。)
ReadElementContentAsString(String, String) 检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配,然后读取当前元素,并将内容作为 String 对象返回。 (继承自 XmlReader。)
ReadElementString() 读取纯文本元素。 (继承自 XmlReader。)
ReadElementString(String) 在读取纯文本元素之前,检查所找到元素的 Name 属性是否与给定的字符串匹配。 (继承自 XmlReader。)
ReadElementString(String, String) 在读取纯文本元素之前,检查所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 (继承自 XmlReader。)
ReadEndElement 检查当前内容节点是否为结束标记并将读取器推进到下一个节点。 (继承自 XmlReader。)
ReadInnerXml 当在派生类中被重写时,将所有内容(包括标记)当做字符串读取。 (继承自 XmlReader。)
ReadOuterXml 当在派生类中被重写时,读取表示该节点和所有它的子级的内容(包括标记)。 (继承自 XmlReader。)
ReadStartElement() 检查当前节点是否为元素并将读取器推进到下一个节点。 (继承自 XmlReader。)
ReadStartElement(String) 检查当前内容节点是否为具有给定 Name 的元素并将读取器推进到下一个节点。 (继承自 XmlReader。)
ReadStartElement(String, String) 检查当前内容节点是否为具有给定 LocalName 和 NamespaceURI 的元素并将读取器推进到下一个节点。 (继承自 XmlReader。)
ReadString 将元素或文本节点的内容读取为一个字符串。 (重写 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 读取嵌入在 XML 文档中的大量文本流。 (继承自 XmlReader。)
ResolveEntity 解析 EntityReference 节点的实体引用。 (重写 XmlReader.ResolveEntity()。)
Skip 跳过当前节点的子级。 (重写 XmlReader.Skip()。)
ToString 返回表示当前对象的字符串。 (继承自 Object。)

提示和注释

注意

在 .NET Framework 2.0 版 中,推荐的做法是使用 XmlReaderSettings 类和 Create 方法创建 XmlReader 实例。 这使您可以充分利用 .NET Framework 中引入的所有新功能。 有关更多信息,请参见 创建 XML 读取器。

XmlNodeReader 能够读取 XML DOM 子树。 此类不支持文档类型定义 (DTD) 或架构验证。 若要执行数据验证,请使用验证 XmlReader 对象。

有关 XmlReader 类的进一步论述,请参见 用 XmlReader 读取 XML。

System.Xml.XmlNodeReader 类例子


继承层次结构

System.Object

System.Xml.XmlReader

System.Xml.XmlNodeReader

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。