Selecionar nós usando a navegação XPath

O DOM (Document Object Model) XML contém métodos que permitem usar a navegação XPath (XML Path Language) para consultar informações no DOM. Você pode usar XPath para encontrar um único nó específico ou para localizar todos os nós que correspondem a alguns critérios.

XPath Select Métodos

As classes DOM fornecem dois métodos para a seleção XPath: o SelectSingleNode método e o SelectNodes método. O SelectSingleNode método retorna o primeiro nó que corresponde aos critérios de seleção. O SelectNodes método retorna um XmlNodeList que contém os nós correspondentes.

O exemplo a seguir usa o SelectSingleNode método para selecionar o primeiro book nó no qual o sobrenome do autor atende aos critérios especificados. O arquivo bookstore.xml (que é fornecido no final deste tópico) é usado como o arquivo de entrada.

Dim doc As New XmlDocument()  
doc.Load("bookstore.xml")  
Dim root As XmlNode = doc.DocumentElement  
  
' Add the namespace.  
Dim nsmgr As New XmlNamespaceManager(doc.NameTable)  
nsmgr.AddNamespace("bk", "urn:newbooks-schema")  
  
' Select and display the first node in which the author's
' last name is Kingsolver.  
Dim node As XmlNode = root.SelectSingleNode( _  
     "descendant::bk:book[bk:author/bk:last-name='Kingsolver']", nsmgr)  
Console.WriteLine(node.InnerXml)  

// Load the document and set the root element.  
XmlDocument doc = new XmlDocument();  
doc.Load("bookstore.xml");  
XmlNode root = doc.DocumentElement;  
  
// Add the namespace.  
XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);  
nsmgr.AddNamespace("bk", "urn:newbooks-schema");  
  
// Select and display the first node in which the author's
// last name is Kingsolver.  
XmlNode node = root.SelectSingleNode(  
    "descendant::bk:book[bk:author/bk:last-name='Kingsolver']", nsmgr);  
Console.WriteLine(node.InnerXml);  

O próximo exemplo usa o SelectNodes método para selecionar todos os nós de livro em que o preço é maior do que um valor especificado. O preço de cada livro da lista selecionada é então programaticamente reduzido em dez por cento. Finalmente, o arquivo atualizado é gravado no console. O arquivo bookstore.xml (que é fornecido no final deste tópico) é usado como o arquivo de entrada.

' Load the document and set the root element.  
Dim doc As New XmlDocument()  
doc.Load("bookstore.xml")  
Dim root As XmlNode = doc.DocumentElement  
  
' Add the namespace.  
Dim nsmgr As New XmlNamespaceManager(doc.NameTable)  
nsmgr.AddNamespace("bk", "urn:newbooks-schema")  
  
' Select all nodes where the book price is greater than 10.00.  
Dim nodeList As XmlNodeList = root.SelectNodes( _  
     "descendant::bk:book[bk:price>10.00]", nsmgr)  
For Each book As XmlNode In nodeList  
     Dim price As Double  
     price = Math.Round(Convert.ToSingle( _  
          book.LastChild.InnerText) * 0.9, 2)  
     book.LastChild.InnerText = price.ToString()  
Next  
  
' Display the updated document.  
doc.Save(Console.Out)  

// Load the document and set the root element.  
XmlDocument doc = new XmlDocument();  
doc.Load("bookstore.xml");  
XmlNode root = doc.DocumentElement;  
  
// Add the namespace.  
XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);  
nsmgr.AddNamespace("bk", "urn:newbooks-schema");  
  
// Select all nodes where the book price is greater than 10.00.  
XmlNodeList nodeList = root.SelectNodes(  
     "descendant::bk:book[bk:price>10.00]", nsmgr);  
foreach (XmlNode book in nodeList)  
{  
     // Discount prices by 10%.  
     double price;  
     price = Math.Round(Convert.ToSingle(  
          book.LastChild.InnerText) * 0.9, 2);  
     book.LastChild.InnerText = price.ToString();  
}  
  
// Display the updated document.  
doc.Save(Console.Out);  

Os exemplos acima iniciam a consulta XPath no elemento do documento. Definir o ponto de partida para a consulta XPath define o nó de contexto, que é o ponto de partida para a consulta XPath. Se você não quiser começar no elemento document, mas quiser começar a partir do primeiro filho do elemento document, você pode codificar a instrução select da seguinte maneira:

doc.DocumentElement.FirstChild.SelectNodes(. . . )  

this doc.DocumentElement.FirstChild.SelectNodes(. . .);  

Todos os XmlNodeList objetos são sincronizados com o documento subjacente. Portanto, se você iterar pela lista de nós e modificar o valor de um nó, esse nó também será atualizado no documento de onde veio. Observe no exemplo anterior que, quando um nó é modificado no documento selecionado XmlNodeList , o documento subjacente também é modificado.

Nota

Quando o documento subjacente é modificado, é aconselhável executar novamente a seleção. Se o nó modificado for aquele que pode fazer com que o nó seja adicionado à lista de nós quando não era anteriormente, ou agora faria com que ele fosse removido da lista de nós, não há garantia de que a lista de nós agora seja precisa.

Namespaces em expressões XPath

As expressões XPath podem incluir namespaces. A resolução de namespace é suportada usando o XmlNamespaceManager. Se a expressão XPath incluir um prefixo, o par URI de prefixo XmlNamespaceManagere namespace deverá ser adicionado ao , e o XmlNamespaceManager será passado para o SelectNodes(String, XmlNamespaceManager) método or SelectSingleNode(String, XmlNamespaceManager) . Observe que os exemplos de código acima usam o XmlNamespaceManager para resolver o namespace do documento bookstore.xml.

Nota

Se a expressão XPath não incluir um prefixo, presume-se que o URI (Uniform Resource Identifier) do namespace é o namespace vazio. Se o XML incluir um namespace padrão, você ainda deverá adicionar um prefixo e um URI de XmlNamespaceManagernamespace ao ; caso contrário, nenhum nó será selecionado.

Arquivo de entrada

A seguir está o arquivo de bookstore.xml usado como o arquivo de entrada nos exemplos deste tópico:

<?xml version='1.0'?>  
<bookstore xmlns="urn:newbooks-schema">  
  <book genre="novel" style="hardcover">  
    <title>The Handmaid's Tale</title>  
    <author>  
      <first-name>Margaret</first-name>  
      <last-name>Atwood</last-name>  
    </author>  
    <price>19.95</price>  
  </book>  
  <book genre="novel" style="other">  
    <title>The Poisonwood Bible</title>  
    <author>  
      <first-name>Barbara</first-name>  
      <last-name>Kingsolver</last-name>  
    </author>  
    <price>11.99</price>  
  </book>  
  <book genre="novel" style="paperback">  
    <title>The Bean Trees</title>  
    <author>  
      <first-name>Barbara</first-name>  
      <last-name>Kingsolver</last-name>  
    </author>  
    <price>5.99</price>  
  </book>  
</bookstore>  

Consulte também

• Modelo de objeto de documento XML (DOM)