Partilhar via


Consultas XPath e namespaces

As consultas XPath estão cientes de namespaces em um documento XML e podem usar prefixos de namespace para qualificar nomes de elementos e atributos. Qualificar nomes de elementos e atributos com um prefixo de namespace limita os nós retornados por uma consulta XPath apenas aos nós que pertencem a um namespace específico.

Por exemplo, se o prefixo books for mapeado para o namespace http://www.contoso.com/books, a consulta /books:books/books:book XPath a seguir selecionará apenas os book elementos no namespace http://www.contoso.com/books.

O XmlNamespaceManager

Para usar namespaces em uma consulta XPath, um objeto derivado da IXmlNamespaceResolver interface como a XmlNamespaceManager classe é construído com o URI e o prefixo do namespace a serem incluídos na consulta XPath.

O XmlNamespaceManager objeto pode ser usado na consulta de cada uma das seguintes maneiras.

A seguir estão os métodos da XPathNavigator classe que aceitam um objeto derivado da IXmlNamespaceResolver interface como um parâmetro.

O namespace padrão

No documento XML a seguir, o namespace padrão com um prefixo vazio é usado para declarar o http://www.contoso.com/books namespace.

<books xmlns="http://www.contoso.com/books">  
    <book>  
        <title>Title</title>  
        <author>Author Name</author>  
        <price>5.50</price>  
    </book>  
</books>  

XPath trata o prefixo vazio como o null namespace. Em outras palavras, apenas prefixos mapeados para namespaces podem ser usados em consultas XPath. Isso significa que, se você quiser consultar um namespace em um documento XML, mesmo que seja o namespace padrão, precisará definir um prefixo para ele.

Por exemplo, sem definir um prefixo para o documento XML acima, a consulta /books/book XPath não retornaria nenhum resultado.

Um prefixo deve ser vinculado para evitar ambiguidade ao consultar documentos com alguns nós que não estão em um namespace e alguns em um namespace padrão.

O código a seguir define um prefixo para o namespace padrão e seleciona todos os book elementos do http://www.contoso.com/books namespace.

Dim document As XPathDocument = New XPathDocument("books.xml")  
Dim navigator As XPathNavigator = document.CreateNavigator()  
Dim query As XPathExpression = navigator.Compile("/books:books/books:book")  
Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)  
manager.AddNamespace("books", "http://www.contoso.com/books")  
query.SetContext(manager)  
Dim nodes As XPathNodeIterator = navigator.Select(query)  
XPathDocument document = new XPathDocument("books.xml");  
XPathNavigator navigator = document.CreateNavigator();  
XPathExpression query = navigator.Compile("/books:books/books:book");  
XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);  
manager.AddNamespace("books", "http://www.contoso.com/books");  
query.SetContext(manager);  
XPathNodeIterator nodes = navigator.Select(query);  

Consulte também