XmlReader.ReadToFollowing XmlReader.ReadToFollowing XmlReader.ReadToFollowing XmlReader.ReadToFollowing Method

Definizione

Prosegue la lettura fino a quando non viene individuato l'elemento denominato.Reads until the named element is found.

Overload

ReadToFollowing(String) ReadToFollowing(String) ReadToFollowing(String) ReadToFollowing(String)

Prosegue la lettura fino a quando non viene individuato un elemento con il nome completo specificato.Reads until an element with the specified qualified name is found.

ReadToFollowing(String, String) ReadToFollowing(String, String) ReadToFollowing(String, String) ReadToFollowing(String, String)

Prosegue la lettura fino a quando non viene individuato un elemento con il nome locale e l'URI dello spazio dei nomi specificati.Reads until an element with the specified local name and namespace URI is found.

ReadToFollowing(String) ReadToFollowing(String) ReadToFollowing(String) ReadToFollowing(String)

Prosegue la lettura fino a quando non viene individuato un elemento con il nome completo specificato.Reads until an element with the specified qualified name is found.

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 String String String

Nome completo dell'elemento.The qualified name of the element.

Restituisce

true se viene individuato un elemento corrispondente; in caso contrario, false e il XmlReader si trova nello stato fine del file.true if a matching element is found; otherwise false and the XmlReader is in an end of file state.

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.

Commenti

Dal punto di vista funzionale, questo metodo equivale following::name a eseguire l'espressione XPath dal nodo corrente.This method is functionally equivalent executing the following::name XPath expression from the current node. Fornisce un modo rapido per trovare un elemento denominato nel documento XML.It provides a quick way to find a named element in the XML document. Sposta il lettore al successivo elemento seguente che corrisponde al nome specificato e restituisce true se viene trovato un elemento corrispondente.It advances the reader to the next following element that matches the specified name and returns true if a matching element is found. Utilizzando l'esempio riportato di seguito, il lettore legge la prima istanza dell'elemento specificato durante la lettura in avanti.Using the example below, the reader would read to the first instance of the specified element while reading forward.

<!--"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 su tutti i tipi di nodo.This method can be called on all node types.

ReadToFollowing(String, String) ReadToFollowing(String, String) ReadToFollowing(String, String) ReadToFollowing(String, String)

Prosegue la lettura fino a quando non viene individuato un elemento con il nome locale e l'URI dello spazio dei nomi specificati.Reads until an element with the specified local name and namespace URI is found.

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 String String String

Nome locale dell'elemento.The local name of the element.

namespaceURI
String String String String

URI dello spazio dei nomi dell'elemento.The namespace URI of the element.

Restituisce

true se viene individuato un elemento corrispondente; in caso contrario, false e il XmlReader si trova nello stato fine del file.true if a matching element is found; otherwise false and the XmlReader is in an end of file state.

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

Dal punto di vista funzionale, questo metodo equivale following::name a eseguire l'espressione XPath dal nodo corrente.This method is functionally equivalent executing the following::name XPath expression from the current node. Fornisce un modo rapido per trovare un elemento denominato nel documento XML.It provides a quick way to find a named element in the XML document. Sposta il lettore al successivo elemento seguente che corrisponde al nome specificato e restituisce true se viene trovato un elemento corrispondente.It advances the reader to the next following element that matches the specified name and returns true if a matching element is found.

<!--"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 su tutti i tipi di nodo.This method can be called on all node types.

Si applica a