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

Definice

Obor názvů:

Microsoft.Office.Tools.Excel

Sestavení:

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

Importuje datový soubor XML do aktuálního sešitu.

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

Parametry

url

String

Adresa URL (Uniform Resource Locator) nebo cesta UNC (Uniform Naming Convention) k datovému souboru XML.

importMap

XmlMap

Mapa schématu, která se použije při importu souboru.

overwrite

Object

Pokud pro parametr není zadána Destination hodnota, pak tento parametr určuje, zda se mají přepsat data, která byla namapována na mapu schématu zadanou v parametru ImportMap . Nastavte na true pro přepsání dat nebo false pro připojení nových dat k existujícím datům. Výchozí hodnota je true. Pokud je pro Destination parametr zadána hodnota, pak tento parametr určuje, zda se mají přepsat existující data. Pokud chcete přepsat existující data, nebo false zrušit import, pokud by se data přepsala, nastavte na true hodnotu . Výchozí hodnota je true.

destination

Object

Data se naimportují do nového seznamu XML v zadaném Range seznamu.

Návraty

XlXmlImportResult

Jedna z XlXmlImportResult hodnot.

Příklady

Následující příklad kódu vytvoří na XmlMap základě schématu vygenerovaného DataSet z DataSet, zapíše do souboru XML a pak použije metodu XmlImport k zápisu dat v souboru XML do oblasti v listu Sheet1.

Tento příklad je pro přizpůsobení na úrovni dokumentu.

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

Poznámky

Nezadávejte hodnotu parametru Destination , pokud chcete importovat data do existujícího mapování.

Následující podmínky způsobí, že tato metoda vygeneruje chyby za běhu:

• Zadaná data XML obsahují chyby syntaxe.

• Proces importu byl zrušen, protože zadaná data se nevejdou na list.

XmlImportXml Pomocí metody importujte data XML, která byla dříve načtena do paměti.

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro Systém Office.