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

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Importa um fluxo de dados XML que tenha sido previamente carregado na memória. Retorna XlXmlImportResult.

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

Public Function XmlImportXml (Data As String, ByRef ImportMap As XmlMap, Optional Overwrite As Object, Optional Destination As Object) As XlXmlImportResult

Parâmetros

Data

String

String necessário. Os dados a serem importados.

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 XmlImport(String, XmlMap, Object, Object) método do objeto para importar um arquivo de Workbook dados XML para a pasta de trabalho atual.