Método Worksheet.XmlMapQuery (Excel)

Retorna um objeto Range que representa as células mapeadas para um XPath específico. Retorna Nothing se o XPath especificado não tiver sido mapeado para a pasta de trabalho.

Sintaxe

expressão. XmlMapQuery (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 mapa XML se quiser consultar o XPath dentro de um mapa específico.

Valor de retorno

Range

Comentários

Ao contrário do método XmlDataQuery , o método XmlMapQuery retorna toda a coluna de uma lista XML, incluindo a linha de cabeçalho.

Observação

O XmlMapQuery permite que os desenvolvedores consultem a existência de mapas específicos. 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 chamada XmlMapQuery para este 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.