XmlReader.ReadToNextSibling Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Sposta l'oggetto XmlReader al successivo elemento corrispondente di pari livello.

Overload

ReadToNextSibling(String)

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

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 -> bool
Public Overridable Function ReadToNextSibling (name As String) As Boolean

Parametri

name
String

Il nome completo dell'elemento di pari livello a cui spostarsi.

Restituisce

Boolean

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

InvalidOperationException

È 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".

ArgumentException

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 -> bool
Public Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As Boolean

Parametri

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

Boolean

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

InvalidOperationException

È 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".

ArgumentNullException

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.

Si applica a