XmlReader.ReadToNextSibling Metoda

Definicja

Przesuwa XmlReader do następnego pasującego elementu równorzędnego.Advances the XmlReader to the next matching sibling element.

Przeciążenia

ReadToNextSibling(String)

Postępuje XmlReader do następnego elementu równorzędnego z określoną nazwą kwalifikowaną.Advances the XmlReader to the next sibling element with the specified qualified name.

ReadToNextSibling(String, String)

Postępuje XmlReader do następnego elementu równorzędnego z określoną nazwą lokalną i identyfikatorem URI przestrzeni nazw.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

ReadToNextSibling(String)

Postępuje XmlReader do następnego elementu równorzędnego z określoną nazwą kwalifikowaną.Advances the XmlReader to the next sibling element with the specified qualified name.

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ść.The qualified name of the sibling element you wish to move to.

Zwraca

true, jeśli zostanie znaleziony pasujący element równorzędny; w przeciwnym razie false.true if a matching sibling element is found; otherwise false. Jeśli nie można odnaleźć pasującego elementu równorzędnego, XmlReader jest umieszczany na tagu końcowym (NodeType jest XmlNodeType.EndElement) elementu nadrzędnego.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

Wyjątki

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Parametr jest pustym ciągiem.The parameter is an empty string.

Przykłady

Poniższy przykład odczytuje atrybut ISBN w każdym węźle książki.The following example reads the ISBN attribute on each book node.

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 wywołuj ReadToNextSibling, gdy XmlReader jest stanem początkowym (ReadState jest Initial).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Możesz wywołać Read, aby przejść do XmlReader, a następnie wywołać metodę ReadToNextSibling.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

ReadToNextSibling(String, String)

Postępuje XmlReader do następnego elementu równorzędnego z określoną nazwą lokalną i identyfikatorem URI przestrzeni nazw.Advances the XmlReader to the next sibling element with the specified local name and 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

Parametry

localName
String

Nazwa lokalna elementu równorzędnego, do którego chcesz przejść.The local name of the sibling element you wish to move to.

namespaceURI
String

Identyfikator URI przestrzeni nazw elementu równorzędnego, do którego chcesz przenieść.The namespace URI of the sibling element you wish to move to.

Zwraca

true, jeśli zostanie znaleziony pasujący element równorzędny; w przeciwnym razie false.true if a matching sibling element is found; otherwise, false. Jeśli nie można odnaleźć pasującego elementu równorzędnego, XmlReader jest umieszczany na tagu końcowym (NodeType jest XmlNodeType.EndElement) elementu nadrzędnego.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

Wyjątki

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Obie wartości parametrów są null.Both parameter values are null.

Uwagi

Uwaga

Nie wywołuj ReadToNextSibling, gdy XmlReader jest stanem początkowym (ReadState jest Initial).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Możesz wywołać Read, aby przejść do XmlReader, a następnie wywołać metodę ReadToNextSibling.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

Dotyczy