XmlReader.ReadToFollowing Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Prosegue la lettura fino a quando non viene individuato l'elemento denominato.

Overload

ReadToFollowing(String)	Legge fino a trovare un elemento con il nome completo specificato.
ReadToFollowing(String, String)	Legge fino a trovare un elemento con il nome locale e l'URI dello spazio dei nomi specificati.

ReadToFollowing(String)

Legge fino a trovare un elemento con il nome completo specificato.

public:
 virtual bool ReadToFollowing(System::String ^ name);

public virtual bool ReadToFollowing (string name);

abstract member ReadToFollowing : string -> bool
override this.ReadToFollowing : string -> bool

Public Overridable Function ReadToFollowing (name As String) As Boolean

Parametri

name

String

Nome completo dell'elemento.

Restituisce

Boolean

true se viene trovato un elemento corrispondente; in caso contrario, false e l'oggetto XmlReader si trova nello stato fine del file.

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.

Commenti

Questo metodo è funzionalmente equivalente all'esecuzione dell'espressione following::name XPath dal nodo corrente. Fornisce un modo rapido per trovare un elemento denominato nel documento XML. Passa il lettore al successivo elemento che corrisponde al nome specificato e restituisce true se viene trovato un elemento corrispondente. Usando l'esempio seguente, il lettore leggerà la prima istanza dell'elemento specificato durante la lettura in avanti.

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item");

Questo metodo può essere chiamato in tutti i tipi di nodo.

ReadToFollowing(String, String)

Legge fino a trovare un elemento con il nome locale e l'URI dello spazio dei nomi specificati.

public:
 virtual bool ReadToFollowing(System::String ^ localName, System::String ^ namespaceURI);

public virtual bool ReadToFollowing (string localName, string namespaceURI);

abstract member ReadToFollowing : string * string -> bool
override this.ReadToFollowing : string * string -> bool

Public Overridable Function ReadToFollowing (localName As String, namespaceURI As String) As Boolean

Parametri

localName

String

Nome locale dell'elemento.

namespaceURI

String

URI dello spazio dei nomi dell'elemento.

Restituisce

Boolean

true se viene trovato un elemento corrispondente; in caso contrario, false e l'oggetto XmlReader si trova nello stato fine del file.

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

Questo metodo è funzionalmente equivalente all'esecuzione dell'espressione following::name XPath dal nodo corrente. Fornisce un modo rapido per trovare un elemento denominato nel documento XML. Passa il lettore al successivo elemento che corrisponde al nome specificato e restituisce true se viene trovato un elemento corrispondente.

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item", "urn:1");

Questo metodo può essere chiamato in tutti i tipi di nodo.