Partilhar via

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

  • Last updated on