XmlReader.ReadToNextSibling Método

Definição

Avança o XmlReader para o próximo elemento irmão correspondente.

Sobrecargas

ReadToNextSibling(String)

Avança o XmlReader para o próximo elemento irmão com o nome qualificado especificado.

ReadToNextSibling(String, String)

Avança o XmlReader para o próximo elemento irmão com o nome local e o URI de namespace especificados.

ReadToNextSibling(String)

Avança o XmlReader para o próximo elemento irmão com o nome qualificado especificado.

public:
 virtual bool ReadToNextSibling(System::String ^ name);
public virtual bool ReadToNextSibling (string name);
abstract member ReadToNextSibling : string -> bool
override this.ReadToNextSibling : string -> bool
Public Overridable Function ReadToNextSibling (name As String) As Boolean

Parâmetros

name
String

O nome qualificado do elemento irmão para o qual você deseja realizar a movimentação.

Retornos

Boolean

true se um elemento irmão correspondente for encontrado; caso contrário, false. Se um elemento irmão correspondente não for encontrado, o XmlReader é posicionado na marca de fim (NodeType é XmlNodeType.EndElement) do elemento pai.

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.

Exemplos

O exemplo a seguir lê o atributo ISBN em cada nó de livro.

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}
Using reader As XmlReader = XmlReader.Create("books.xml")
  reader.ReadToFollowing("book")
  Do
    Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"))
  Loop While reader.ReadToNextSibling("book")
End Using

Comentários

Observação

Não chame ReadToNextSibling quando o XmlReader estado é inicial (ReadState é Initial). Você pode chamar Read para avançar e XmlReader , em seguida, chamar o ReadToNextSibling método.

Aplica-se a

ReadToNextSibling(String, String)

Avança o XmlReader para o próximo elemento irmão com o nome local e o URI de namespace especificados.

public:
 virtual bool ReadToNextSibling(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToNextSibling (string localName, string namespaceURI);
abstract member ReadToNextSibling : string * string -> bool
override this.ReadToNextSibling : string * string -> bool
Public Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As Boolean

Parâmetros

localName
String

O nome local do elemento irmão para o qual você deseja.

namespaceURI
String

O URI do namespace do elemento irmão para o qual você deseja mover.

Retornos

Boolean

true se um elemento irmão correspondente for encontrado; caso contrário, false. Se um elemento irmão correspondente não for encontrado, o XmlReader é posicionado na marca de fim (NodeType é XmlNodeType.EndElement) do elemento pai.

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

Observação

Não chame ReadToNextSibling quando o XmlReader estado é inicial (ReadState é Initial). Você pode chamar Read para avançar e XmlReader , em seguida, chamar o ReadToNextSibling método.

Aplica-se a