_Workbook.XmlImport(String, XmlMap, Object, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 XlXmlImportResultParâ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
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.