_Workbook.XmlImport(String, XmlMap, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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

public Microsoft.Office.Interop.Excel.XlXmlImportResult XmlImport (string Url, out Microsoft.Office.Interop.Excel.XmlMap ImportMap, object Overwrite, object Destination);

Public Function XmlImport (Url As String, ByRef ImportMap As XmlMap, Optional Overwrite As Object, Optional Destination As Object) As XlXmlImportResult

Parâmetros

Url

String

String necessário. Um caminho de URL (localizador de recursos) uniforme ou uma UNC (convenção de nomenclatura uniforme) para um arquivo de dados XML.

ImportMap

XmlMap

Necessário XmlMap. O mapa de esquema a ser aplicado durante a importação do arquivo.

Overwrite

Object

Booliano opcional. Se um valor não for especificado para o Destination parâmetro, esse parâmetro especifica se deve ou não substituir dados mapeados para o mapa de esquema especificado no ImportMap parâmetro. 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 Destination parâmetro, esse parâmetro especifica se deve ou não 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.

Destination

Object

Opcional Range. Os dados serão importados para uma nova lista XML no intervalo especificado.

Retornos

XlXmlImportResult

Comentários

Os recursos XML, exceto para salvar arquivos no formato de Planilha XML, estão disponíveis apenas no Microsoft Office Professional Edition 2003 e no Microsoft Office Excel 2003.

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

As seguintes condições farão 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.

Use o XmlImportXml(String, XmlMap, Object, Object) método do Workbook objeto para importar dados XML que foram carregados anteriormente na memória.