Metodo WorkbookBase.XmlImport

Articolo
05/17/2013

Importa un file di dati XML nella cartella di lavoro corrente.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
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
)

Parametri

url
Tipo: System.String
Percorso URL (Uniform Resource Locator) o percorso UNC (Uniform Naming Convention) di un file di dati XML.

importMap
Tipo: Microsoft.Office.Interop.Excel.XmlMap%
Mappa dello schema da applicare per l'importazione del file.

overwrite
Tipo: System.Object
Se non è specificato un valore per il parametro Destination, tale parametro specifica se sovrascrivere o meno i dati che sono stati mappati alla mappa dello schema specificata nel parametro ImportMap.Impostare su true per sovrascrivere i dati o su false per aggiungere i nuovi dati a quelli esistenti.Il valore predefinito è true.Se viene specificato un valore per il parametro Destination, tale parametro indica se sovrascrivere o meno i dati esistenti.Impostare su true per sovrascrivere i dati esistenti o su false per annullare l'importazione se i dati vengono sovrascritti.Il valore predefinito è true.

destination
Tipo: System.Object
I dati saranno importati in un nuovo elenco XML in corrispondenza dell'oggetto Range specificato.

Valore restituito

Tipo: Microsoft.Office.Interop.Excel.XlXmlImportResult
Uno dei valori di XlXmlImportResult.

Note

Non specificare un valore per il parametro Destination se si desidera importare dati in un mapping esistente.

In presenza delle seguenti condizioni il metodo genererà errori di runtime:

I dati XML specificati contengono errori di sintassi.
Il processo di importazione è stato annullato in quanto i dati specificati non si adattano alle dimensioni del foglio di lavoro.

Utilizzare il metodo XmlImportXml per importare dati XML precedentemente caricati in memoria.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente viene creato un oggetto XmlMap sulla base di uno schema generato da DataSet, l'oggetto DataSet viene scritto in un file XML e infine viene utilizzato il metodo XmlImport per scrivere i dati del file XML in un intervallo del foglio di lavoro Sheet1.

Questo esempio è valido per una personalizzazione a livello di 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"];
    this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

WorkbookBase Classe

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite