XmlReader.ReadToFollowing 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

在找到具名項目之前讀取。

多載

ReadToFollowing(String)	在找到具有指定限定名稱的項目之前讀取。
ReadToFollowing(String, String)	在找到具有指定區域名稱和命名空間 URI 的項目之前讀取。

ReadToFollowing(String)

來源:

XmlReader.cs

在找到具有指定限定名稱的項目之前讀取。

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)

來源:

XmlReader.cs

在找到具有指定區域名稱和命名空間 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");

這個方法可以在所有節點類型上呼叫。