Método Workbook.XmlImport

Artigo
05/21/2013

Importa um arquivo de dados XML na pasta de trabalho atual.

Namespace: Microsoft.Office.Tools.Excel
Assemblies: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Function XmlImport ( _
    Url As String, _
    <OutAttribute> ByRef ImportMap As XmlMap, _
    Overwrite As Object, _
    Destination As Object _
) As XlXmlImportResult

XlXmlImportResult XmlImport(
    string Url,
    out XmlMap ImportMap,
    Object Overwrite,
    Object Destination
)

Parâmetros

Url
Tipo: System.String
Um localizador de recursos uniforme (URL) ou um caminho de (UNC) convenção de nomeclatura de uniforme para um arquivo de dados XML.

ImportMap
Tipo: Microsoft.Office.Interop.Excel.XmlMap%
O mapeamento de esquema para aplicar ao importar o arquivo.

Overwrite
Tipo: System.Object
Se não for especificado um valor para o parâmetro de Destination , então este parâmetro especifica se substituir os dados que foram mapeados para o mapa de esquema especificado no parâmetro de ImportMap .Defina a true para substituir os dados ou false para anexar novos dados aos dados existentes.O valor padrão é true.Se um valor especificado para o parâmetro de Destination , então este parâmetro especifica se substituir dados existentes.Defina a true para substituir dados existentes ou false para cancelar a importação se os dados devem ser substituídos.O valor padrão é true.

Destination
Tipo: System.Object
Os dados serão importados em uma nova lista XML em Range especificado.

Valor de retorno

Tipo: Microsoft.Office.Interop.Excel.XlXmlImportResult
Um dos valores de XlXmlImportResult .

Comentários

Não especificar um valor para o parâmetro de Destination se você deseja importar dados em um mapeamento existente.

As seguintes condições farão com que este método gera erros em tempo de execução:

Os dados especificados XML contém erros de sintaxe.
O processo de importação foi cancelado porque os dados especificados não podem caber na planilha.

Use o método de XmlImportXml para importar os dados XML que foram previamente carregados na memória.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Workbook Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via