Especificar Namespace ao consultar o DOM com o XPath

Este artigo descreve que você deve usar nomes qualificados ao usar a consulta XPath com o selectSingleNode e selectNodes os métodos do IXMLDOMNode objeto.

Versão original do produto: Analisador do Microsoft XML
Número de KB original: 294797

Resumo

Com a versão do XML Parser (MSXML) 3.0, XPath fornece uma maneira conveniente de consultar documentos XML e retornar um nó ou um conjunto de nós. Ao usar XPath a consulta com os selectSingleNode métodos e selectNodes do IXMLDOMNode objeto, você deve usar nomes qualificados. Por exemplo, para selecionar o nó Book com os seguintes dados XML:

<?xml version ="1.0"?>
<a:Books xmlns:a="x-schema:bookschema.xml" >
    <a:Book>
        <title>Presenting XML</title>
        <author>Richard Light</author>
    </a:Book>
</a:Books>

se usarmos um como alias do x-schema:bookschema.xml URI (Uniform Resource Identifier), a consulta XPath correspondente será a seguinte:

pXMLDoc->setProperty("SelectionNamespaces","xmlns:a='x-schema:bookschema.xml'");
pXMLDoc->documentElement->selectNodes("/a:Books/a:Book");

Nesse caso, usar o nome qualificado é simples. No entanto, quando o namespace padrão é usado, o uso do nome qualificado pode ser mais difícil, como no exemplo a seguir:

<?xml version ="1.0"?>
<Books xmlns="x-schema:bookschema.xml" >
    <Book>
        <title>Presenting XML</title>
        <author>Richard Light</author>
    </Book>
</Books>

Mais informações

O exemplo do Visual C++ a seguir é fornecido para demonstrar a técnica.

Para especificar o namespace ao consultar o DOM com XPath, siga estas etapas:

1. Crie um projeto de console do Win32 e adicione um novo arquivo .cpp ao projeto. Cole o seguinte código no arquivo .cpp e nomeie o arquivo Test.cpp:

   #include <stdio.h>
   
   #import "msxml3.dll"
   using namespace MSXML2;
   
   void dump_com_error(_com_error &e);
   
   int main(int argc, char* argv[])
   {
       CoInitialize(NULL);
       try{
           IXMLDOMDocument2Ptr pXMLDoc;
           HRESULT hr = pXMLDoc.CreateInstance(__uuidof(DOMDocument));
   
           pXMLDoc->async = false; // default - true,
   
           pXMLDoc->validateOnParse = true;
   
           hr = pXMLDoc->load("books.xml");
   
           if(hr!=VARIANT_TRUE)
           {
               IXMLDOMParseErrorPtr pError;
   
               pError = pXMLDoc->parseError;
               _bstr_t parseError =_bstr_t("At line ")+ _bstr_t(pError->Getline()) + _bstr_t("\n")+
               _bstr_t(pError->Getreason());
               MessageBox(NULL,parseError, "Parse Error",MB_OK);
               return -1;
           }
   
           hr = pXMLDoc->setProperty("SelectionLanguage", "XPath");
           hr = pXMLDoc->setProperty("SelectionNamespaces", "xmlns:a='x-schema:bookschema.xml'");
   
           IXMLDOMNodeListPtr pNodeList;
           pNodeList = pXMLDoc->documentElement->selectNodes("/a:Books/a:Book");
           int count = pNodeList->Getlength();
           char pLength[64];
           sprintf(pLength, "Total number of nodes selected is %d", count);
           MessageBox(NULL,pLength,"Test", MB_OK);
   
       }
       catch(_com_error &e)
       {
           dump_com_error(e);
           return -1;
       }
       return 0;
   }
   
   void dump_com_error(_com_error &e)
   {
       printf("Error\n");
       printf("\a\tCode = %08lx\n", e.Error());
       printf("\a\tCode meaning = %s", e.ErrorMessage());
       _bstr_t bstrSource(e.Source());
       _bstr_t bstrDescription(e.Description());
       printf("\a\tSource = %s\n", (LPCSTR) bstrSource);
       printf("\a\tDescription = %s\n", (LPCSTR) bstrDescription);
   }
   

2. Salve o XML a seguir como Books.xml na mesma pasta de projeto que Test.cpp.

   <?xml version ="1.0"?>
   <Books xmlns="x-schema:bookschema.xml" >
   <Book>
   <title>Presenting XML</title>
   <author>Richard Light</author>
   <pages>334</pages>
   </Book>
   <Book>
   <title>Mastering XML</title>
   <author>John Smith</author>
   <pages>209</pages>
   </Book>
   </Books>
   

3. Salve o XML a seguir como Bookschema.xml na mesma pasta de projeto que Test.cpp.

   <?xml version="1.0"?>
   <Schema xmlns="urn:schemas-microsoft-com:xml-data">
   <ElementType name="title" />
   <ElementType name="author" />
   <ElementType name="pages" />
   <ElementType name="Book" model="closed">
   <element type="title" />
   <element type="author" />
   <element type="pages" />
   </ElementType>
   <ElementType name="Books" model="closed">
   <element type="Book" />
   </ElementType>
   </Schema>
   

4. Compile e execute o aplicativo. Uma caixa de mensagem mostra o número de nós que são retornados pela XPath consulta. Veja o seguinte:

   • O mesmo código de exemplo pode ser usado com um URI explícito como um namespace.

   • Nas linhas a seguir

     IXMLDOMDocument2Ptr pXMLDoc;
     ...
     hr = pXMLDoc->setProperty("SelectionLanguage", "XPath");
     hr = pXMLDoc->setProperty("SelectionNamespaces", "xmlns:a='x-schema:bookschema.xml'");
     ...
     pNodeList = pXMLDoc->documentElement->selectNodes("/a:Books/a:Book");
     

     o setProperty método não está disponível com a IXMLDOMDocument interface.

Um nome qualificado (QName) é composto por um prefixo e uma parte local. O prefixo fornece o prefixo namespace do nome qualificado e deve ser associado a um URI de namespace.

Referências

Como usar o XPath para consultar um namespace padrão definido pelo usuário