XmlReader.ReadToFollowing Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Liest, bis das benannte Element gefunden wird.

Überlädt

ReadToFollowing(String)	Liest, bis ein Element mit dem angegebenen qualifizierten Namen gefunden wird.
ReadToFollowing(String, String)	Liest, bis ein Element mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI gefunden wird.

ReadToFollowing(String)

Quelle:

XmlReader.cs

Liest, bis ein Element mit dem angegebenen qualifizierten Namen gefunden wird.

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

Parameter

name

String

Der qualifizierte Name des Elements.

Gibt zurück

Boolean

true, wenn ein übereinstimmendes Element gefunden wird, andernfalls false, und der XmlReader in einem Dateiendezustand.

Ausnahmen

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

ArgumentException

Der Parameter ist eine leere Zeichenfolge.

Hinweise

Diese Methode entspricht funktionell der Ausführung des following::name XPath-Ausdrucks vom aktuellen Knoten. Es bietet eine schnelle Möglichkeit, ein benanntes Element im XML-Dokument zu finden. Es bringt den Reader zum nächsten folgenden Element, das dem angegebenen Namen entspricht, und gibt zurück true , wenn ein übereinstimmende Element gefunden wird. Im folgenden Beispiel würde der Leser beim Vorwärtslesen in die erste Instanz des angegebenen Elements einlesen.

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

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

reader.ReadToFollowing("item");

Diese Methode kann für alle Knotentypen aufgerufen werden.

ReadToFollowing(String, String)

Quelle:

XmlReader.cs

Liest, bis ein Element mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI gefunden wird.

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

Parameter

localName

String

Der lokale Name des Elements.

namespaceURI

String

Der Namespace-URI des Elements.

Gibt zurück

Boolean

true, wenn ein übereinstimmendes Element gefunden wird, andernfalls false, und der XmlReader in einem Dateiendezustand.

Ausnahmen

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

ArgumentNullException

Beide Parameterwerte sind null.

Hinweise

Diese Methode entspricht funktionell der Ausführung des following::name XPath-Ausdrucks vom aktuellen Knoten. Es bietet eine schnelle Möglichkeit, ein benanntes Element im XML-Dokument zu finden. Es bringt den Reader zum nächsten folgenden Element, das dem angegebenen Namen entspricht, und gibt zurück true , wenn ein übereinstimmende Element gefunden wird.

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

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

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

Diese Methode kann für alle Knotentypen aufgerufen werden.