XmlReader.ReadToFollowing Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

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

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

Boolean

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

Exceções

InvalidOperationException

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”.

ArgumentException

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

ReadToFollowing(String, String)

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

Boolean

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

Exceções

InvalidOperationException

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”.

ArgumentNullException

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