XmlReader.ReadToNextSibling XmlReader.ReadToNextSibling XmlReader.ReadToNextSibling XmlReader.ReadToNextSibling Method

Definizione

Sposta l'oggetto XmlReader al successivo elemento corrispondente di pari livello.Advances the XmlReader to the next matching sibling element.

Overload

ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String)

Sposta l'oggetto XmlReader al successivo elemento di pari livello con il nome completo specificato.Advances the XmlReader to the next sibling element with the specified qualified name.

ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String)

Sposta l'oggetto XmlReader al successivo elemento di pari livello con il nome locale e l'URI dello spazio dei nomi specificati.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String)

Sposta l'oggetto XmlReader al successivo elemento di pari livello con il nome completo specificato.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

Parametri

name
String String String String

Il nome completo dell'elemento di pari livello a cui spostarsi.The qualified name of the sibling element you wish to move to.

Restituisce

true se viene rilevato un elemento corrispondente di pari livello; in caso contrario, false.true if a matching sibling element is found; otherwise false. Se non viene trovato un elemento corrispondente di pari livello, l'oggetto XmlReader viene posizionato in corrispondenza del tag di fine (NodeType è XmlNodeType.EndElement) dell'elemento padre.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

Eccezioni

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Il parametro è una stringa vuota.The parameter is an empty string.

Esempi

L'esempio seguente legge l'attributo ISBN in ogni nodo libro.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

Commenti

Nota

Non chiamare ReadToNextSibling quando il XmlReader è uno stato iniziale (ReadState è Initial).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). È possibile chiamare Read per passare il XmlReader e quindi chiamare il ReadToNextSibling (metodo).You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String)

Sposta l'oggetto XmlReader al successivo elemento di pari livello con il nome locale e l'URI dello spazio dei nomi specificati.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

Parametri

localName
String String String String

Nome locale dell'elemento di pari livello a cui spostarsi.The local name of the sibling element you wish to move to.

namespaceURI
String String String String

URI dello spazio dei nomi dell'elemento di pari livello a cui spostarsi.The namespace URI of the sibling element you wish to move to.

Restituisce

true se viene trovato un elemento di pari livello corrispondente; in caso contrario, false.true if a matching sibling element is found; otherwise, false. Se non viene trovato un elemento corrispondente di pari livello, l'oggetto XmlReader viene posizionato in corrispondenza del tag di fine (NodeType è XmlNodeType.EndElement) dell'elemento padre.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

Eccezioni

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Entrambi i valori del parametro sono null.Both parameter values are null.

Commenti

Nota

Non chiamare ReadToNextSibling quando il XmlReader è uno stato iniziale (ReadState è Initial).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). È possibile chiamare Read per passare il XmlReader e quindi chiamare il ReadToNextSibling (metodo).You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

Si applica a