Compartilhar via


Método Workbook.XmlImport (Excel)

Importa um arquivo de dados XML para a pasta de trabalho atual.

Sintaxe

expressão. XmlImport (Url, ImportMap, Overwrite, Destination)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Url Obrigatório String Um caminho de URL (localizador de recursos) uniforme ou uma UNC (convenção de nomenclatura uniforme) para um arquivo de dados XML.
ImportMap Obrigatório XmlMap O mapa de esquema a ser aplicado durante a importação do arquivo. Se os dados foram importados anteriormente, contém uma referência para o objeto XmlMap contendo os dados.
Overwrite Opcional Variantes Se um valor não for especificado para o parâmetro Destino , esse parâmetro especifica se deve substituir os dados mapeados para o mapa de esquema especificado no parâmetro ImportMap . Defina como True para substituir os dados ou False para anexar os novos dados aos dados existentes. O valor padrão é True.

Se um valor for especificado para o parâmetro Destino , esse parâmetro especifica se deve substituir os dados existentes. Defina como True para substituir os dados existentes ou False para cancelar a importação se os dados forem substituídos. O valor padrão é True.
Destino Opcional Variantes Especifica o intervalo no qual a lista será criada. Você só usa o canto superior esquerdo do intervalo.

Valor de retorno

XlXmlImportResult

Comentários

Este método permite a importação dos dados na pasta de trabalho a partir de um caminho de arquivo. O Excel usa o primeiro mapa de qualificação encontrado ou, se o intervalo de destino for especificado, o Excel lista automaticamente os dados.

Não especifique um valor para o parâmetro Destination se você quiser importar os dados para um mapeamento existente.

As seguintes condições fazem com que o método XmlImport gere erros de tempo de execução:

  • Os dados XML especificados contêm erros de sintaxe.

  • O processo de importação foi cancelado porque os dados especificados não cabem na planilha.

  • Se nenhum mapa de qualificação for encontrado e o intervalo de destino não for especificado.

Use o método XmlImportXml do objeto Workbook para importar dados XML que foram carregados anteriormente na memória.

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.