XmlReader.ReadToFollowing Metodo

Definizione

Legge fino a trovare l'elemento denominato.Reads until the named element is found.

Overload

ReadToFollowing(String)

Legge fino a trovare un elemento con il nome completo specificato.Reads until an element with the specified qualified name is found.

ReadToFollowing(String, String)

Legge fino a trovare 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)

Legge fino a trovare 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

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

Restituisce

true se viene trovato un elemento corrispondente; in caso contrario, false e l'oggetto 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 a eseguire l'espressione XPath following::name 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)

Legge fino a trovare 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

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

namespaceURI
String

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

Restituisce

true se viene trovato un elemento corrispondente; in caso contrario, false e l'oggetto 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 a eseguire l'espressione XPath following::name 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