WorkbookBase.XmlImport – metoda

Článek
01/03/2014

Importuje datového souboru XML do aktuálního sešitu.

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 cesty úmluvy (UNC) do datového souboru XML.

importMap
Typ: Microsoft.Office.Interop.Excel.XmlMap%
Mapa schématu, která se použije při importu souboru.

overwrite
Typ: System.Object
Pokud pro parametr Destination není zadána hodnota, tento parametr určí, zda se mají přepsat data mapovaná do mapy schématu zadané v parametru ImportMap.Nastavte na hodnotu true pro přepsání dat, nebo na hodnotu false pro připojení nových dat k existujícím datům.Výchozí hodnota je true.Pokud je pro parametr Destination zadána hodnota, tento parametr určí, zda se mají přepsat existující data.Nastavte na hodnotu true pro přepsání existujících dat, nebo na hodnotu false, chcete-li import zrušit, pokud by data byla 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
Jedna z hodnot XlXmlImportResult

Poznámky

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

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.

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

Volitelné parametry

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

Příklady

Následující příklad kódu vytvoří XmlMap založené na schématu generovaných DataSet, zapíše DataSet do souboru XML a používá XmlImport metody zápisu dat do souboru XML na oblast v listu Sheet1.

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

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