XmlReader.ReadToFollowing Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Přečte, dokud se nenajde pojmenovaný prvek.

Přetížení

Name	Description
ReadToFollowing(String)	Přečte, dokud se nenajde prvek se zadaným kvalifikovaným názvem.
ReadToFollowing(String, String)	Přeč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

Přeč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 na konci 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 zpráva "Asynchronní operace už probíhá".

ArgumentException

Parametr je prázdný řetězec.

Poznámky

Tato metoda je funkčně ekvivalentní provádění výrazu following::name XPath z aktuálního uzlu. Poskytuje rychlý způsob, jak najít pojmenovaný prvek v dokumentu XML. Přejde č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 přečetl první instanci 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 u všech typů uzlů.

ReadToFollowing(String, String)

Zdroj:

XmlReader.cs

Přeč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 na konci 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 zpráva "Asynchronní operace už probíhá".

ArgumentNullException

Obě hodnoty parametrů jsou null.

Poznámky

Tato metoda je funkčně ekvivalentní provádění výrazu following::name XPath z aktuálního uzlu. Poskytuje rychlý způsob, jak najít pojmenovaný prvek v dokumentu XML. Přejde č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 u všech typů uzlů.