XmlReader.ReadToFollowing Método

Definição

Lê até que o elemento nomeado seja encontrado.Reads until the named element is found.

Sobrecargas

ReadToFollowing(String)

Lê até que seja encontrado um elemento com o nome qualificado especificado.Reads until an element with the specified qualified name is found.

ReadToFollowing(String, String)

Lê até que seja encontrado um elemento com o nome do local e o URI do namespace especificados.Reads until an element with the specified local name and namespace URI is found.

ReadToFollowing(String)

Lê até que seja encontrado um elemento com o nome qualificado especificado.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

Parâmetros

name
String

O nome qualificado do elemento.The qualified name of the element.

Retornos

Boolean

true se um elemento correspondente for encontrado; caso contrário, false e o XmlReader estará em um estado de fim do arquivo.true if a matching element is found; otherwise false and the XmlReader is in an end of file state.

Exceções

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

O parâmetro é uma cadeia de caracteres vazia.The parameter is an empty string.

Comentários

Esse método é funcionalmente equivalente a executar a following::name expressão XPath do nó atual.This method is functionally equivalent executing the following::name XPath expression from the current node. Ele fornece uma maneira rápida de localizar um elemento nomeado no documento XML.It provides a quick way to find a named element in the XML document. Ele avança o leitor para o próximo elemento seguinte que corresponde ao nome especificado e retorna true se um elemento correspondente é encontrado.It advances the reader to the next following element that matches the specified name and returns true if a matching element is found. Usando o exemplo a seguir, o leitor lerá a primeira instância do elemento especificado durante a leitura posterior.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");  

Esse método pode ser chamado em todos os tipos de nó.This method can be called on all node types.

Aplica-se a

ReadToFollowing(String, String)

Lê até que seja encontrado um elemento com o nome do local e o URI do namespace especificados.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

Parâmetros

localName
String

O nome local do elemento.The local name of the element.

namespaceURI
String

O URI do namespace do elemento.The namespace URI of the element.

Retornos

Boolean

true se um elemento correspondente for encontrado; caso contrário, false e o XmlReader estará em um estado de fim do arquivo.true if a matching element is found; otherwise false and the XmlReader is in an end of file state.

Exceções

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Ambos os valores de parâmetro são null.Both parameter values are null.

Comentários

Esse método é funcionalmente equivalente a executar a following::name expressão XPath do nó atual.This method is functionally equivalent executing the following::name XPath expression from the current node. Ele fornece uma maneira rápida de localizar um elemento nomeado no documento XML.It provides a quick way to find a named element in the XML document. Ele avança o leitor para o próximo elemento seguinte que corresponde ao nome especificado e retorna true se um elemento correspondente é encontrado.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");  

Esse método pode ser chamado em todos os tipos de nó.This method can be called on all node types.

Aplica-se a