WorkbookBase.XmlImport – metoda

Článek
05/14/2013

Importuje soubor XML dat s aktuálním sešitem.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

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

Parametry

url
Typ: System.String
Uniform resource locator (URL) nebo uniform naming convention () cesty do datového souboru XML.

importMap
Typ: Microsoft.Office.Interop.Excel.XmlMap%
Mapa schématu, které chcete použít při importu souboru.

overwrite
Typ: System.Object
Pokud není zadána hodnota Destination parametr, pak tento parametr určuje, zda chcete přepsat data, která byla namapována na uvedené v mapě schématu ImportMap parametr.Nastavte na true k přepsání dat nebo false na nová data připojit k existující data.Výchozí hodnota je true.Pokud je zadána hodnota Destination parametr, pak tento parametr určuje, zda chcete nebo nechcete přepsat existující data.Nastavte na true Chcete-li přepsat existující data nebo false -li import zrušit, pokud by data přepsána.Výchozí hodnota je true.

destination
Typ: System.Object
Data budou importována do nového seznamu XML na Range zadané.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Excel.XlXmlImportResult
Jeden z XlXmlImportResult hodnoty.

Poznámky

Nezadávejte hodnotu Destination parametr, chcete-li importovat data do existujícího mapování.

Tato metoda generovat chyby run-time způsobí, že následující podmínky:

Zadaná data XML obsahuje syntaktické chyby.
Proces importu byl zrušen, protože zadaná data nelze umístit do listu.

Použití XmlImportXml metodu, chcete-li importovat data XML, která byla dříve načtena do paměti.

Volitelné parametry

Informace o volitelných parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu vytvoří XmlMap na základě schématu, z DataSet, zapíše DataSet do souboru XML a potom používá XmlImport způsob zápisu dat do souboru XML pro oblast na listu Sheet1.

V tomto příkladu je úroveň dokument přizpůsobení.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

WorkbookBase Třída

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím