XmlReader.ReadToFollowing 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

一直读取，直到找到命名元素。

重载

ReadToFollowing(String)	一直读取，直到找到具有指定限定名的元素。
ReadToFollowing(String, String)	一直读取，直到找到具有指定的本地名称和命名空间 URI 的元素。

ReadToFollowing(String)

一直读取，直到找到具有指定限定名的元素。

public:
 virtual bool ReadToFollowing(System::String ^ name);

public virtual bool ReadToFollowing (string name);

abstract member ReadToFollowing : string -> bool
override this.ReadToFollowing : string -> bool

Public Overridable Function ReadToFollowing (name As String) As Boolean

参数

name

String

元素的限定名。

返回

Boolean

如果找到匹配的元素，则为 true；否则为 false 且 XmlReader 位于文件的末尾。

例外

InvalidOperationException

在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

ArgumentException

参数是空字符串。

注解

此方法在功能上等效于从当前节点执行 following::name XPath 表达式。 它提供了在 XML 文档中查找命名元素的快速方法。 它将读取器推进到与指定名称匹配的下一个元素，并在找到匹配元素时返回 true 。 使用以下示例，读取器会在向前读取时读取到指定元素的第一个实例。

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item");

可以在所有节点类型上调用此方法。

ReadToFollowing(String, String)

一直读取，直到找到具有指定的本地名称和命名空间 URI 的元素。

public:
 virtual bool ReadToFollowing(System::String ^ localName, System::String ^ namespaceURI);

public virtual bool ReadToFollowing (string localName, string namespaceURI);

abstract member ReadToFollowing : string * string -> bool
override this.ReadToFollowing : string * string -> bool

Public Overridable Function ReadToFollowing (localName As String, namespaceURI As String) As Boolean

参数

localName

String

元素的本地名称。

namespaceURI

String

元素的命名空间 URI。

返回

Boolean

如果找到匹配的元素，则为 true；否则为 false 且 XmlReader 位于文件的末尾。

例外

InvalidOperationException

在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

ArgumentNullException

两个参数值均为 null。

注解

此方法在功能上等效于从当前节点执行 following::name XPath 表达式。 它提供了在 XML 文档中查找命名元素的快速方法。 它将读取器推进到与指定名称匹配的下一个元素，并在找到匹配元素时返回 true 。

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item", "urn:1");

可以在所有节点类型上调用此方法。