本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

WorkbookBase.XmlImport 方法 (String, XmlMap, Object, Object)

 

將 XML 資料檔匯入目前活頁簿。

命名空間:   Microsoft.Office.Tools.Excel
組件:  Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)

public XlXmlImportResult XmlImport(
	string url,
	out XmlMap importMap,
	object overwrite,
	object destination
)

參數

url

連接 XML 資料檔的統一資源定位器 (URL) 或統一命名慣例 (UNC) 路徑。

importMap

匯入檔案時套用的結構描述對應。

overwrite

如果未指定 Destination 參數的值,則此參數指出是否覆寫已對應至 ImportMap 參數指定的結構描述對應之資料。  設定為 true 表示要覆寫資料,設定為 false 表示要將新資料附加至現有資料中。  預設值是 true  如果已指定 Destination 參數的值,此參數會指出是否覆寫現有資料。  設定為 true 表示要覆寫現有資料,如果資料可能會被覆寫,則設定為 false 以取消匯入。  預設值是 true  

destination

資料會匯入 Range 指定的新 XML 清單。

如果您要將資料匯入現有的對應,請勿指定 Destination 參數值。

下列情況會導致這個方法產生執行階段錯誤:

  • 指定的 XML 資料內含語法錯誤。

  • 取消匯入程序,因為指定的資料在工作表中無法適用。

使用 XmlImportXml 方法匯入先前已載入記憶體的 XML 資料。

如需選擇性參數的詳細資訊,請參閱Office 方案中的選擇性參數

下列程式碼會根據由 DataSet 產生的結構描述,建立 XmlMap,然後將 DataSet 寫入至 XML 檔案,再使用 XmlImport 方法,將這個 XML 檔案的資料寫入至活頁簿 Sheet1 的某個範圍中。

這是示範文件層級自訂的範例。

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);
}
回到頁首
顯示: