Método Worksheet.XmlDataQuery (Excel)

  • Artigo

Retorna um objeto Range que representa as células mapeadas para um XPath específico. Retorna Nothing se o XPath especificado não foi mapeado para a pasta de trabalho, ou se o intervalo mapeado estiver vazio.

Sintaxe

expressão. XmlDataQuery (XPath, SelectionNamespaces, Mapa)

Expressão Uma variável que representa um objeto Worksheet .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
XPath Obrigatório String O XPath a ser consultado.
SelectionNamespaces Opcional Variantes Uma String com espaço delimitado que contém os espaços paa nomes citados no parâmetro XPath. Um erro de tempo de execução será gerado se um dos namespaces especificados não puder ser resolvido.
Map Opcional Variantes Especifique um XmlMap se quiser consultar o XPath em um mapa específico.

Valor de retorno

Range

Comentários

Se o XPath existir dentro de um coluna em uma lista XML, o objeto Range retornado não inclui a linha de cabeçalho.

Este método retorna Nothing se o caminho do local do XPath não estiver mapeado na grade. Dessa forma, um retorno de Nothing não significa necessariamente que o mapa não existe. Poderia significar que não existe atualmente um intervalo de dados disponível no local do XPath especificado. Use o método XmlMapQuery para verificar a existência de um XPath mapeado.

Observação

O método XmlDataQuery permite a consulta da existência de dados específicos de mapa. Ele não pode ser usado para consultar um pedaço de dados em um mapa.

Por exemplo, ele é válido para que exista um intervalo mapeado no qual o XPath para esse intervalo é "/root/People[@Age="23"]/FirstName". Uma consulta XmlDataQuery para este caminho de localização XPath retorna o intervalo correto. No entanto, uma consulta para "/root/People[FirstName="Joe"]" esperar encontrar "Joe" dentro do intervalo mapeado acima falha porque as definições XPath para os intervalos mapeados são diferentes.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.