XmlReader.ReadToDescendant Metodo

Definizione

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

Sposta l'oggetto XmlReader all'elemento discendente corrispondente successivo.

Overload

Nome Descrizione
ReadToDescendant(String, String)

Sposta l'oggetto XmlReader all'elemento discendente successivo con il nome locale e l'URI dello spazio dei nomi specificati.
ReadToDescendant(String)

Sposta l'oggetto XmlReader all'elemento discendente successivo con il nome completo specificato.

ReadToDescendant(String, String)

Sposta l'oggetto XmlReader all'elemento discendente successivo con il nome locale e l'URI dello spazio dei nomi specificati.

public:
 virtual bool ReadToDescendant(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToDescendant(string localName, string namespaceURI);
abstract member ReadToDescendant : string * string -> bool
override this.ReadToDescendant : string * string -> bool
Public Overridable Function ReadToDescendant (localName As String, namespaceURI As String) As Boolean

Parametri

localName
String

Nome locale dell'elemento in cui si desidera spostarsi.

namespaceURI
String

URI dello spazio dei nomi dell'elemento a cui si desidera passare.

Valori restituiti

Boolean

true se viene trovato un elemento discendente corrispondente; in caso contrario false, . Se non viene trovato un elemento discendente corrispondente, l'oggetto XmlReader viene posizionato sul tag di fine (NodeType è XmlNodeType.EndElement) dell'elemento .

Se l'oggetto XmlReader non è posizionato su un elemento quando ReadToDescendant(String, String) è stato chiamato, questo metodo restituisce false e la posizione di XmlReader non viene modificata.

Eccezioni

InvalidOperationException

È stato chiamato un XmlReader metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

ArgumentNullException

Entrambi i valori dei parametri sono null.

Si applica a

ReadToDescendant(String)

Sposta l'oggetto XmlReader all'elemento discendente successivo con il nome completo specificato.

public:
 virtual bool ReadToDescendant(System::String ^ name);
public virtual bool ReadToDescendant(string name);
abstract member ReadToDescendant : string -> bool
override this.ReadToDescendant : string -> bool
Public Overridable Function ReadToDescendant (name As String) As Boolean

Parametri

name
String

Nome completo dell'elemento in cui si desidera spostarsi.

Valori restituiti

Boolean

true se viene trovato un elemento discendente corrispondente; in caso contrario false, . Se non viene trovato un elemento discendente corrispondente, l'oggetto XmlReader viene posizionato sul tag di fine (NodeType è XmlNodeType.EndElement) dell'elemento .

Se l'oggetto XmlReader non è posizionato su un elemento quando ReadToDescendant(String) è stato chiamato, questo metodo restituisce false e la posizione di XmlReader non viene modificata.

Eccezioni

InvalidOperationException

È stato chiamato un XmlReader metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

ArgumentException

Il parametro è una stringa vuota.

Esempio

Nell'esempio seguente viene analizzato il secondo nodo libro.

using (XmlReader reader = XmlReader.Create("2books.xml")) {

  // Move the reader to the second book node.
  reader.MoveToContent();
  reader.ReadToDescendant("book");
  reader.Skip(); //Skip the first book.

  // Parse the file starting with the second book node.
  do {
     switch (reader.NodeType) {
        case XmlNodeType.Element:
           Console.Write("<{0}", reader.Name);
           while (reader.MoveToNextAttribute()) {
               Console.Write(" {0}='{1}'", reader.Name, reader.Value);
           }
           Console.Write(">");
           break;
        case XmlNodeType.Text:
           Console.Write(reader.Value);
           break;
        case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
     }
  }  while (reader.Read());
}

Using reader As XmlReader = XmlReader.Create("2books.xml")

  ' Move the reader to the second book node.
  reader.MoveToContent()
  reader.ReadToDescendant("book")
  reader.Skip() 'Skip the first book.
  ' Parse the file starting with the second book node.
  Do
    Select Case reader.NodeType
      Case XmlNodeType.Element
        Console.Write("<{0}", reader.Name)
        While reader.MoveToNextAttribute()
            Console.Write(" {0}='{1}'", reader.Name, reader.Value)
        End While
        Console.Write(">")
      Case XmlNodeType.Text
        Console.Write(reader.Value)
      Case XmlNodeType.EndElement
        Console.Write("</{0}>", reader.Name)
    End Select
  Loop While reader.Read()

End Using

Nell'esempio viene usato il file , 2books.xml, come input.

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

Si applica a