Freigeben über


XmlReader.ReadToNextSibling Methode

Definition

Wechselt zum XmlReader nächsten übereinstimmenden gleichgeordneten Element.

Überlädt

Name Beschreibung
ReadToNextSibling(String)

Wechselt zum XmlReader nächsten gleichgeordneten Element mit dem angegebenen qualifizierten Namen.

ReadToNextSibling(String, String)

Wechselt zum XmlReader nächsten gleichgeordneten Element mit dem angegebenen lokalen Namen und namespace-URI.

ReadToNextSibling(String)

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

Wechselt zum XmlReader nächsten gleichgeordneten 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 gleichgeordneten Elements, zu dem Sie wechseln möchten.

Gibt zurück

true wenn ein übereinstimmender gleichgeordnetes Element gefunden wird; andernfalls false. Wenn ein übereinstimmender gleichgeordnetes Element nicht gefunden wird, wird es XmlReader am 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 InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 es XmlReader sich um einen Anfangszustand handelt (ReadState ist Initial). Sie können die Methode aufrufen Read , um weiter XmlReader zu wechseln und dann die ReadToNextSibling Methode aufzurufen.

Gilt für:

ReadToNextSibling(String, String)

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

Wechselt zum XmlReader nächsten gleichgeordneten Element mit dem angegebenen lokalen Namen und 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 gleichgeordneten Elements, zu dem Sie wechseln möchten.

namespaceURI
String

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

Gibt zurück

truewenn ein übereinstimmender gleichgeordnetes Element gefunden wird; andernfalls . false Wenn ein übereinstimmender gleichgeordnetes Element nicht gefunden wird, wird es XmlReader am 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 InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Beide Parameterwerte sind null.

Hinweise

Hinweis

Rufen Sie nicht auf ReadToNextSibling , wenn es XmlReader sich um einen Anfangszustand handelt (ReadState ist Initial). Sie können die Methode aufrufen Read , um weiter XmlReader zu wechseln und dann die ReadToNextSibling Methode aufzurufen.

Gilt für: