Udostępnij za pośrednictwem

Excel.Workbook

  • Artykuł

Składnia

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

Około

Zwraca zawartość skoroszytu programu Excel.

  • useHeaders może mieć wartość null, wartość logiczna (prawda/fałsz) wskazująca, czy pierwszy wiersz każdej zwracanej tabeli powinien być traktowany jako nagłówek, czy rekord opcji. Wartość domyślna: false.
  • delayTypes może mieć wartość null lub wartość logiczną (prawda/fałsz) wskazującą, czy kolumny każdej zwracanej tabeli powinny pozostać niewytypowane. Wartość domyślna: false.

Jeśli rekord jest określony dla useHeaders (a delayTypes ma wartość null), można podać następujące pola rekordów:

  • UseHeaders: może mieć wartość null lub wartość logiczną (true/false) wskazującą, czy pierwszy wiersz każdej zwracanej tabeli powinien być traktowany jako nagłówek. Wartość domyślna: false.
  • DelayTypes: może mieć wartość null lub wartość logiczną (prawda/fałsz) wskazującą, czy kolumny każdej zwracanej tabeli powinny pozostać bez określonego typu. Wartość domyślna: false.
  • InferSheetDimensions: może mieć wartość null lub wartość logiczną (prawda/fałsz) wskazującą, czy obszar arkusza zawierającego dane powinien zostać wywnioskowany przez odczytanie samego arkusza, a nie odczytanie metadanych wymiarów z pliku. Może to być przydatne w przypadkach, gdy metadane wymiarów są nieprawidłowe. Należy pamiętać, że ta opcja jest obsługiwana tylko w przypadku plików programu Excel Open XML, a nie starszych plików programu Excel. Wartość domyślna: false.

Notatka

Parametr useHeaders lub pole rekordu UseHeaders konwertuje liczby i daty na tekst przy użyciu bieżącej kultury, a tym samym zachowuje się inaczej podczas uruchamiania w środowiskach z różnymi kulturami systemu operacyjnego ustawionymi. Zalecamy użycie Table.PromoteHeaders zamiast tego. Na przykład zamiast używać Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) lub Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null))zamiast tego należy użyć Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])).

Przykład 1

Zwróć zawartość arkusza Sheet1 ze skoroszytu Excel.

użycie

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

Wyjście

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