XmlReader.ReadToNextSibling Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

XmlReader Przechodzi do następnego pasującego elementu równorzędnego.

Przeciążenia

ReadToNextSibling(String)	XmlReader Przechodzi do następnego elementu równorzędnego z określoną kwalifikowaną nazwą.
ReadToNextSibling(String, String)	XmlReader Przechodzi do następnego elementu równorzędnego przy użyciu określonej lokalnej nazwy i identyfikatora URI przestrzeni nazw.

ReadToNextSibling(String)

XmlReader Przechodzi do następnego elementu równorzędnego z określoną kwalifikowaną nazwą.

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

Parametry

name

String

Kwalifikowana nazwa elementu równorzędnego, do którego chcesz przejść.

Zwraca

Boolean

true w przypadku znalezienia pasującego elementu równorzędnego; w przeciwnym razie false. Jeśli pasujący element równorzędny nie zostanie znaleziony, XmlReader element jest umieszczony na tagu końcowym (NodeType to XmlNodeType.EndElement) elementu nadrzędnego.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentException

Parametr jest pustym ciągiem.

Przykłady

Poniższy przykład odczytuje atrybut ISBN w każdym węźle książki.

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

Uwagi

Uwaga

Nie należy wywoływać ReadToNextSibling , gdy XmlReader wartość jest w stanie początkowym (ReadState to Initial). Możesz wywołać Read metodę , aby przejść do XmlReader metody , a następnie wywołać metodę ReadToNextSibling .

ReadToNextSibling(String, String)

XmlReader Przechodzi do następnego elementu równorzędnego przy użyciu określonej lokalnej nazwy i identyfikatora URI przestrzeni nazw.

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

Parametry

localName

String

Lokalna nazwa elementu równorzędnego, do którego chcesz przejść.

namespaceURI

String

Identyfikator URI przestrzeni nazw elementu równorzędnego, do którego chcesz przejść.

Zwraca

Boolean

true w przypadku znalezienia pasującego elementu równorzędnego; w przeciwnym razie , false. Jeśli pasujący element równorzędny nie zostanie znaleziony, XmlReader element jest umieszczony na tagu końcowym (NodeType to XmlNodeType.EndElement) elementu nadrzędnego.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentNullException

Obie wartości parametrów to null.

Uwagi

Uwaga

Nie należy wywoływać ReadToNextSibling , gdy XmlReader wartość jest w stanie początkowym (ReadState to Initial). Możesz wywołać Read metodę , aby przejść do XmlReader metody , a następnie wywołać metodę ReadToNextSibling .