XmlReader.ReadToNextSibling 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

让 XmlReader 前进到下一个匹配的同级元素。

重载

ReadToNextSibling(String)	让 XmlReader 前进到下一个具有指定限定名的同级元素。
ReadToNextSibling(String, String)	将 XmlReader 推进到具有指定的本地名称和命名空间 URI 的下一个同级元素。

ReadToNextSibling(String)

Source:

XmlReader.cs

让 XmlReader 前进到下一个具有指定限定名的同级元素。

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

public virtual bool ReadToNextSibling (string name);

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

Public Overridable Function ReadToNextSibling (name As String) As Boolean

参数

name

String

要移动到的同级元素的限定名。

返回

Boolean

如果找到匹配的同级元素，则为 true；否则为 false。 如果没有找到匹配的同级元素，XmlReader 会定位在父元素的结束标记（NodeType 为 XmlNodeType.EndElement）上。

例外

InvalidOperationException

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

ArgumentException

参数是空字符串。

示例

以下示例读取每个书籍节点上的 ISBN 属性。

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}

Using reader As XmlReader = XmlReader.Create("books.xml")
  reader.ReadToFollowing("book")
  Do
    Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"))
  Loop While reader.ReadToNextSibling("book")
End Using

注解

注意

当 是初始状态 () ReadStateInitial 时XmlReader，请勿调用 ReadToNextSibling 。 可以调用 Read 来推进 ， XmlReader 然后调用 ReadToNextSibling 方法。

ReadToNextSibling(String, String)

Source:

XmlReader.cs

将 XmlReader 推进到具有指定的本地名称和命名空间 URI 的下一个同级元素。

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

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

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

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

参数

localName

String

要移动到的同级元素的本地名称。

namespaceURI

String

你希望移动到的同级元素的命名空间 URI。

返回

Boolean

如果找到匹配的同级元素，则为 true；否则为 false。 如果没有找到匹配的同级元素，XmlReader 会定位在父元素的结束标记（NodeType 为 XmlNodeType.EndElement）上。

例外

InvalidOperationException

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

ArgumentNullException

两个参数值均为 null。

注解

备注

当 是初始状态 () ReadStateInitial 时XmlReader，请勿调用 ReadToNextSibling 。 可以调用 Read 来推进 ， XmlReader 然后调用 ReadToNextSibling 方法。