XmlReader.ReadToNextSibling Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

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.

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.

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

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

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.