XmlReader.ReadToFollowing Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Čte, dokud není nalezen pojmenovaný prvek.

Přetížení

ReadToFollowing(String)	Čte, dokud se nenajde prvek se zadaným kvalifikovaným názvem.
ReadToFollowing(String, String)	Čte, dokud se nenajde prvek se zadaným místním názvem a identifikátorem URI oboru názvů.

ReadToFollowing(String)

Zdroj:

XmlReader.cs

Čte, dokud se nenajde prvek se zadaným kvalifikovaným názvem.

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

Parametry

name

String

Kvalifikovaný název elementu.

Návraty

Boolean

true pokud je nalezen odpovídající prvek; jinak false a je XmlReader v koncovém stavu souboru.

Výjimky

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

ArgumentException

Parametr je prázdný řetězec.

Poznámky

Tato metoda je funkčně ekvivalentní spuštění výrazu following::name XPath z aktuálního uzlu. Poskytuje rychlý způsob, jak najít pojmenovaný element v dokumentu XML. Posune čtenáře na další následující prvek, který odpovídá zadanému názvu, a vrátí true , pokud je nalezen odpovídající prvek. Při použití následujícího příkladu by čtenář při čtení vpřed četl do první instance zadaného prvku.

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

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

reader.ReadToFollowing("item");

Tuto metodu lze volat na všech typech uzlů.

ReadToFollowing(String, String)

Zdroj:

XmlReader.cs

Čte, dokud se nenajde prvek se zadaným místním názvem a identifikátorem URI oboru názvů.

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

Parametry

localName

String

Místní název elementu.

namespaceURI

String

Identifikátor URI oboru názvů elementu.

Návraty

Boolean

true pokud je nalezen odpovídající prvek; jinak false a je XmlReader v koncovém stavu souboru.

Výjimky

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

ArgumentNullException

Obě hodnoty parametrů jsou null.

Poznámky

Tato metoda je funkčně ekvivalentní spuštění výrazu following::name XPath z aktuálního uzlu. Poskytuje rychlý způsob, jak najít pojmenovaný element v dokumentu XML. Posune čtenáře na další následující prvek, který odpovídá zadanému názvu, a vrátí true , pokud je nalezen odpovídající prvek.

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

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

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

Tuto metodu lze volat na všech typech uzlů.