XmlReader.ReadToNextSibling Método

Definição

Avança o XmlReader para o próximo elemento irmão correspondente.Advances the XmlReader to the next matching sibling element.

Sobrecargas

ReadToNextSibling(String)

Avança o XmlReader para o próximo elemento irmão com o nome qualificado especificado.Advances the XmlReader to the next sibling element with the specified qualified name.

ReadToNextSibling(String, String)

Avança o XmlReader para o próximo elemento irmão com o nome local e o URI de namespace especificados.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

ReadToNextSibling(String)

Avança o XmlReader para o próximo elemento irmão com o nome qualificado especificado.Advances the XmlReader to the next sibling element with the specified qualified name.

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.The qualified name of the sibling element you wish to move to.

Retornos

Boolean

true se um elemento irmão correspondente for encontrado; caso contrário, false.true if a matching sibling element is found; otherwise false. Se um elemento irmão correspondente não for encontrado, o XmlReader é posicionado na marca de fim (NodeType é XmlNodeType.EndElement) do elemento pai.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

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.

Exemplos

O exemplo a seguir lê o atributo ISBN em cada nó de livro.The following example reads the ISBN attribute on each book node.

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 é um estado inicial ( ReadState is Initial ).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Você pode chamar Read para avançar XmlReader e, em seguida, chamar o ReadToNextSibling método.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

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.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

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.The local name of the sibling element you wish to move to.

namespaceURI
String

O URI do namespace do elemento irmão para o qual você deseja mover.The namespace URI of the sibling element you wish to move to.

Retornos

Boolean

true se um elemento irmão correspondente for encontrado; caso contrário, false.true if a matching sibling element is found; otherwise, false. Se um elemento irmão correspondente não for encontrado, o XmlReader é posicionado na marca de fim (NodeType é XmlNodeType.EndElement) do elemento pai.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

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

Observação

Não chame ReadToNextSibling quando o XmlReader é um estado inicial ( ReadState is Initial ).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Você pode chamar Read para avançar XmlReader e, em seguida, chamar o ReadToNextSibling método.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

Aplica-se a