Sdílet prostřednictvím

Excel.Workbook

  • Článek

Syntax

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

Asi

Vrátí obsah excelového sešitu.

  • useHeaders může mít hodnotu null, logickou hodnotu (true/false), která označuje, jestli se má první řádek každé vrácené tabulky považovat za záhlaví nebo záznam možností. Výchozí hodnota: false.
  • delayTypes může mít hodnotu null nebo logickou hodnotu (true/false), která označuje, jestli mají být sloupce každé vrácené tabulky ponechány bez textu. Výchozí hodnota: false.

Pokud je pro useHeaders zadaný záznam (a delayTypes má hodnotu null), mohou být zadána následující pole záznamů:

  • UseHeaders: Může mít hodnotu null nebo logickou hodnotu (true/false), která označuje, jestli má být první řádek každé vrácené tabulky považován za záhlaví. Výchozí hodnota: false.
  • DelayTypes: Může mít hodnotu null nebo logickou hodnotu (true/false), která označuje, zda mají být sloupce každé vrácené tabulky ponechány bez typu. Výchozí hodnota: false.
  • InferSheetDimensions: Může mít hodnotu null nebo logickou hodnotu (true/false), která označuje, jestli má být oblast listu obsahující data odvozena čtením samotného listu, nikoli čtením metadat dimenzí ze souboru. To může být užitečné v případech, kdy jsou metadata dimenzí nesprávná. Upozorňujeme, že tato možnost je podporována pouze pro excelové soubory Open XML, ne pro starší verze excelových souborů. Výchozí hodnota: false.

Poznámka

Parametr useHeaders nebo pole záznamu UseHeaders převádí čísla a kalendářní data na text pomocí aktuální jazykové verze, a proto se při spuštění v prostředích s jinou jazykovou verzí operačního systému chová odlišně. Místo toho doporučujeme používat Table.PromoteHeaders. Například místo použití Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) nebo Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null))použijte místo toho Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])).

Příklad 1

Vrátí obsah Listu1 z excelového sešitu.

využití

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

Výstup

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"]
})