WorkbookBase.XmlImport(String, XmlMap, Object, Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

public Microsoft.Office.Interop.Excel.XlXmlImportResult XmlImport (string url, out Microsoft.Office.Interop.Excel.XmlMap importMap, object overwrite, object destination);

member this.XmlImport : string * XmlMap * obj * obj -> Microsoft.Office.Interop.Excel.XlXmlImportResult

Public Function XmlImport (url As String, ByRef importMap As XmlMap, Optional overwrite As Object, Optional destination As Object) As XlXmlImportResult

Parametri

url: String

Percorso URL (Uniform Resource Locator) o percorso UNC (Uniform Naming Convention) di un file di dati XML.

importMap: XmlMap

Mappa dello schema da applicare per l'importazione del file.

overwrite: Object

Se per il Destination parametro non viene specificato un valore, questo parametro specifica se sovrascrivere o meno i dati di cui è stato eseguito il ImportMap mapping alla mappa dello schema specificata nel parametro . Impostare su true per sovrascrivere i dati o su false per aggiungere i nuovi dati a quelli esistenti. Il valore predefinito è true. Se per il Destination parametro viene specificato un valore, questo parametro specifica 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: Object

I dati saranno importati in un nuovo elenco XML in corrispondenza dell'oggetto Range specificato.

Restituisce

XlXmlImportResult

Uno dei valori di XlXmlImportResult.

Esempio

Nell'esempio di codice seguente viene creato un XmlMap oggetto basato su uno schema generato da un DataSetoggetto , viene scritto in DataSet un file XML e quindi viene utilizzato il XmlImport metodo per scrivere i dati nel file XML in un intervallo nel foglio di lavoro Sheet1.

Questo esempio è relativo a una personalizzazione a livello di documento.

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);
}

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

Commenti

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

Le condizioni seguenti causeranno la generazione di errori di run-time da parte di questo metodo:

I dati XML specificati contengono errori di sintassi.
Il processo di importazione è stato annullato perché i dati specificati non possono essere inseriti nel foglio di lavoro.

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

Parametri facoltativi

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

Si applica a

Condividi tramite