Freigeben über


XmlReader.ReadToFollowing Methode

Definition

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
Quelle:
XmlReader.cs
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

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

Ausnahmen

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.

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.

Gilt für:

ReadToFollowing(String, String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
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

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

Ausnahmen

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.

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.

Gilt für: