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. A qualificação de nomes de elementos e atributos com um prefixo de namespace limita os nós retornados por uma consulta XPath somente aos nós que pertencem a um namespace específico.

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

XmlNamespaceManager

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

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

• O XmlNamespaceManager objeto é associado a um objeto existente XPathExpression usando o SetContext método do XPathExpression objeto. Você também pode compilar um novo XPathExpression objeto usando o método estático Compile que usa uma cadeia de caracteres que representa a expressão XPath e um XmlNamespaceManager objeto como parâmetros e retorna um novo XPathExpression objeto.

• O objeto XmlNamespaceManager em si é passado como um parâmetro para um método de classe XPathNavigator que aceita, juntamente com uma string que representa a expressão XPath.

Veja a seguir os métodos da XPathNavigator classe que aceitam um objeto derivado da IXmlNamespaceResolver interface como um parâmetro.

• Evaluate

• Select

• SelectSingleNode

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>  

O XPath trata o prefixo vazio como o null namespace. Em outras palavras, somente 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, será necessário 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 associado 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 no 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

• XmlDocument
• XPathDocument
• XPathNavigator
• Processar dados XML usando o modelo de dados XPath
• Selecionar dados XML usando XPathNavigator
• Avaliar expressões XPath usando XPathNavigator
• Nós compatíveis usando XPathNavigator
• Tipos de nós reconhecidos com consultas XPath
• Expressões XPath compiladas