Método WorkbookBase.XmlImport

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
Public Function XmlImport ( _
    url As String, _
    <OutAttribute> ByRef importMap As XmlMap, _
    overwrite As Object, _
    destination As Object _
) As XlXmlImportResult

public 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 UNC (convenção) de nomenclatura uniforme para um arquivo de dados XML.

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

overwrite
Tipo: System.Object
Se não for especificado um valor para o Destination parâmetro e, em seguida, este parâmetro especifica se deve ou não sobrescrever os dados que foi mapeados para o mapa de esquema especificado na ImportMap parâmetro.Definido como true para sobrescrever os dados ou false para acrescentar novos dados para os dados existentes.O valor padrão é true.Se um valor for especificado para o Destination parâmetro, e em seguida, este parâmetro especifica se ou não substituir dados existentes.Definido como true para substituir dados existentes ou false para cancelar a importação, se os dados precisarem ser substituídos.O valor padrão é true.

destination
Tipo: System.Object
Os dados serão importados para uma nova lista XML com o Range especificado.

Valor de retorno

Tipo: Microsoft.Office.Interop.Excel.XlXmlImportResult
Dentre as XlXmlImportResult valores.

Comentários

Não especificar um valor para o Destination parâmetro se desejar importar dados de um mapeamento existente.

As seguintes condições fará com que esse método para gerar 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 método para importar dados XML, que tem sido previamente carregados na memória.

Optional Parameters

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

Exemplos

O exemplo de código a seguir cria um XmlMap com base em um esquema gerado a partir de um DataSet, grava o DataSet para um arquivo XML e, em seguida, usa o XmlImport método para gravar os dados no arquivo XML a um intervalo na planilha Sheet1.

Este exemplo é para uma personalização em nível de documento.

Private Sub WorkbookXmlImport()

    ' Create a new DataTable.
    Dim ds As New DataSet()
    Dim dt As DataTable = ds.Tables.Add("Customers")
    dt.Columns.Add(New DataColumn("LastName"))
    dt.Columns.Add(New DataColumn("FirstName"))

    ' Add a new row to the DataTable.
    Dim dr As DataRow = dt.NewRow()
    dr("LastName") = "Chan"
    dr("FirstName") = "Gareth"
    dt.Rows.Add(dr)

    ' Add a new XML map and write the XML to a file.
    Dim xmlMap1 As Excel.XmlMap = Me.XmlMaps.Add(ds.GetXmlSchema(), _
        "NewDataSet")
    ds.WriteXml("C:\Customers.xml")

    ' Import the XML from the file.
    Dim range1 As Excel.Range = Globals.Sheet1.Range("A1")
    Me.XmlImport("C:\Customers.xml", xmlMap1, True, _
        range1)
End Sub

private void WorkbookXmlImport()
{
    // Create a new DataTable.
    DataSet ds = new DataSet();
    DataTable dt = ds.Tables.Add("Customers");
    dt.Columns.Add(new DataColumn("LastName"));
    dt.Columns.Add(new DataColumn("FirstName"));

    // Add a new row to the DataTable.
    DataRow dr = dt.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    dt.Rows.Add(dr);

    // Add a new XML map and write the XML to a file.
    Excel.XmlMap xmlMap1 = this.XmlMaps.Add(ds.GetXmlSchema(),
        "NewDataSet");
    ds.WriteXml(@"C:\Customers.xml");

    // Import the XML from the file.
    Excel.Range range1 = Globals.Sheet1.Range["A1", missing];
    this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}

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

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Partilhar via