閱讀英文

共用方式為


Excel.Workbook

語法

Excel.Workbook(workbook as binary, optional useHeaders as any, optional delayTypes as nullable logical) as table

關於

傳回 Excel 活頁簿的內容。

  • useHeaders 可為 null 或邏輯 (true/false) 值,表示是否應將每個傳回資料表的第一個資料列視為標頭,或選項記錄。 預設:false。
  • delayTypes 可為 null 或邏輯 (true/false) 值,表示每個傳回資料表的資料行是否應保留為不具類型。 預設:false。

如果針對 useHeaders 指定了記錄 (且 delayTypes 為 null),則可提供下列記錄欄位:

  • UseHeaders:可為 null 或邏輯 (true/false) 值,表示是否應將每個傳回資料表的第一個資料列視為標頭。 預設:false。
  • DelayTypes:可為 null 或邏輯 (true/false) 值,表示每個傳回資料表的資料行是否應保留為不具類型。 預設:false。
  • InferSheetDimensions:可為 null 或邏輯 (true/false) 值,表示是否應讀取工作表本身,而非讀取檔案中的維度中繼資料,來推斷包含資料的工作表區域。 在維度中繼資料不正確的情況下,這會很有幫助。 請注意,此選項僅支援 Open XML Excel 檔案,不適用於舊版 Excel 檔案。 預設:false。

注意

useHeaders 參數或 UseHeaders 記錄欄位會使用目前文化特性將數位和日期轉換成文字,因此在設定不同作業系統文化特性的環境中執行時的行為會有所不同。 建議您改用 Table.PromoteHeaders。 例如,不要使用 Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true))Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null)),而是改用 Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true]))

範例 1

從 Excel 活頁簿退回 Sheet1 的內容。

使用方式

Excel.Workbook(File.Contents("C:\Book1.xlsx"), null, true){[Item="Sheet1"]}[Data]

輸出

Table.FromRecords({
    [Column1 = "ID", Column2 = "Name", Column3 = "Phone"],
    [Column1 = 1, Column2 = "Bob", Column3 = "123-4567"],
    [Column1 = 3, Column2 = "Pam", Column3 = "543-7890"],
    [Column1 = 2, Column2 = "Jim", Column3 = "987-6543"]
})