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 方法。