Partilhar via


XmlReader.ReadToFollowing Método

Definição

Lê até que o elemento nomeado seja encontrado.

Sobrecargas

ReadToFollowing(String)

Lê até que seja encontrado um elemento com o nome qualificado especificado.

ReadToFollowing(String, String)

Lê até que seja encontrado um elemento com o nome do local e o URI do namespace especificados.

ReadToFollowing(String)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Lê até que seja encontrado um elemento com o nome qualificado especificado.

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.

Retornos

true se um elemento correspondente for encontrado; caso contrário, false e o XmlReader estará em um estado de fim do arquivo.

Exceções

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

O parâmetro é uma cadeia de caracteres vazia.

Comentários

Esse método é funcionalmente equivalente à execução da following::name expressão XPath do nó atual. Ele fornece uma maneira rápida de encontrar um elemento nomeado no documento XML. Ele avança o leitor para o próximo elemento a seguir que corresponde ao nome especificado e retorna true se um elemento correspondente é encontrado. Usando o exemplo abaixo, o leitor leria para a primeira instância do elemento especificado durante a leitura.

<!--"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ó.

Aplica-se a

ReadToFollowing(String, String)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Lê até que seja encontrado um elemento com o nome do local e o URI do namespace especificados.

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.

namespaceURI
String

O URI do namespace do elemento.

Retornos

true se um elemento correspondente for encontrado; caso contrário, false e o XmlReader estará em um estado de fim do arquivo.

Exceções

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Ambos os valores de parâmetro são null.

Comentários

Esse método é funcionalmente equivalente à execução da following::name expressão XPath do nó atual. Ele fornece uma maneira rápida de encontrar um elemento nomeado no documento XML. Ele avança o leitor para o próximo elemento a seguir que corresponde ao nome especificado e retorna true se um elemento correspondente é encontrado.

<!--"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ó.

Aplica-se a