XmlReader.ReadToNextSibling Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

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)

Source:

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

Boolean

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

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.

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.

ReadToNextSibling(String, String)

Source:

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

Boolean

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

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

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.