Freigeben über


XmlReader.ReadToNextSibling Methode

Definition

Verschiebt den XmlReader auf das nächste übereinstimmende nebengeordnete Element.

Überlädt

ReadToNextSibling(String)

Verschiebt den XmlReader auf das nächste nebengeordnete Element mit dem angegebenen qualifizierten Namen.

ReadToNextSibling(String, String)

Verschiebt den XmlReader auf das nächste nebengeordnete Element mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.

ReadToNextSibling(String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Verschiebt den XmlReader auf das nächste nebengeordnete Element mit dem angegebenen qualifizierten Namen.

public:
 virtual bool ReadToNextSibling(System::String ^ name);
public virtual bool ReadToNextSibling (string name);
abstract member ReadToNextSibling : string -> bool
override this.ReadToNextSibling : string -> bool
Public Overridable Function ReadToNextSibling (name As String) As Boolean

Parameter

name
String

Der qualifizierte Name des nebengeordneten Elements, zu dem Sie wechseln möchten.

Gibt zurück

true, wenn ein übereinstimmendes nebengeordnetes Element gefunden wurde, andernfalls false. Wenn kein übereinstimmendes nebengeordnetes Element gefunden wurde, wird der XmlReader auf dem Endtag (NodeType ist XmlNodeType.EndElement) des übergeordneten Elements positioniert.

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.

Beispiele

Im folgenden Beispiel wird das ISBN-Attribut auf jedem Buchknoten gelesen.

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}
Using reader As XmlReader = XmlReader.Create("books.xml")
  reader.ReadToFollowing("book")
  Do
    Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"))
  Loop While reader.ReadToNextSibling("book")
End Using

Hinweise

Hinweis

Rufen Sie nicht auf ReadToNextSibling , wenn der XmlReader ein Anfangszustand ist (ReadState ist Initial). Sie können aufrufen Read , um die XmlReader -Methode voranzutreiben und dann die ReadToNextSibling -Methode aufzurufen.

Gilt für:

ReadToNextSibling(String, String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Verschiebt den XmlReader auf das nächste nebengeordnete Element mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.

public:
 virtual bool ReadToNextSibling(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToNextSibling (string localName, string namespaceURI);
abstract member ReadToNextSibling : string * string -> bool
override this.ReadToNextSibling : string * string -> bool
Public Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As Boolean

Parameter

localName
String

Der lokale Name des nebengeordneten Elements, zu dem Sie wechseln möchten.

namespaceURI
String

Der Namespace-URI des nebengeordneten Elements, zu dem Sie wechseln möchten.

Gibt zurück

true, wenn ein übereinstimmendes nebengeordnetes Element gefunden wurde, andernfalls false. Wenn kein übereinstimmendes nebengeordnetes Element gefunden wurde, wird der XmlReader auf dem Endtag (NodeType ist XmlNodeType.EndElement) des übergeordneten Elements positioniert.

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

Hinweis

Rufen Sie nicht auf ReadToNextSibling , wenn der XmlReader ein Anfangszustand ist (ReadState ist Initial). Sie können aufrufen Read , um die XmlReader -Methode voranzutreiben und dann die ReadToNextSibling -Methode aufzurufen.

Gilt für: