XmlReader.ReadToNextSibling Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Sposta l'oggetto XmlReader al successivo elemento corrispondente di pari livello.
Overload
| ReadToNextSibling(String) |
Sposta l'oggetto |
| ReadToNextSibling(String, String) |
Sposta l'oggetto |
ReadToNextSibling(String)
Sposta l'oggetto XmlReader al successivo elemento di pari livello con il nome completo specificato.
public:
virtual bool ReadToNextSibling(System::String ^ name);public virtual bool ReadToNextSibling (string name);abstract member ReadToNextSibling : string -> bool
override this.ReadToNextSibling : string -> boolPublic Overridable Function ReadToNextSibling (name As String) As BooleanParametri
- name
- String
Il nome completo dell'elemento di pari livello a cui spostarsi.
Restituisce
true se viene trovato un elemento di pari livello corrispondente; in caso contrario, 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.
Eccezioni
È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".
Il parametro è una stringa vuota.
Esempio
Nell'esempio seguente viene letto l'attributo ISBN in ogni nodo del libro.
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 l'oggetto XmlReader è uno stato iniziale (ReadState è Initial). È possibile chiamare Read per avanzare e XmlReader quindi chiamare il ReadToNextSibling metodo.
Si applica a
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.
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 -> boolPublic Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As BooleanParametri
- localName
- String
Nome locale dell'elemento di pari livello a cui spostarsi.
- namespaceURI
- String
URI dello spazio dei nomi dell'elemento di pari livello a cui spostarsi.
Restituisce
true se viene trovato un elemento di pari livello corrispondente; in caso contrario, 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.
Eccezioni
È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".
Entrambi i valori del parametro sono null.
Commenti
Nota
Non chiamare ReadToNextSibling quando l'oggetto XmlReader è uno stato iniziale (ReadState è Initial). È possibile chiamare Read per avanzare e XmlReader quindi chiamare il ReadToNextSibling metodo.