Condividi tramite

Excel.Workbook

  • Articolo

Sintassi

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

Informazioni su

Restituisce il contenuto della cartella di lavoro di Excel.

  • useHeaders può essere Null, un valore logico (true/false) che indica se la prima riga di ogni tabella restituita deve essere considerata come un'intestazione o un record di opzioni. Valore predefinito: false.
  • delayTypes può essere Null o un valore logico (true/false) che indica se le colonne di ogni tabella restituita devono essere lasciate non tipizzate. Valore predefinito: false.

Se si specifica un record per useHeaders (e delayTypes è Null), è possibile fornire i campi di record seguenti:

  • UseHeaders: può essere Null o un valore logico (true/false) che indica se la prima riga di ogni tabella restituita deve essere considerata come un'intestazione. Valore predefinito: false.
  • DelayTypes: può essere Null o un valore logico (true/false) che indica se le colonne di ogni tabella restituita devono essere lasciate non tipizzate. Valore predefinito: false.
  • InferSheetDimensions: può essere Null o un valore logico (true/false) che indica se l'area di un foglio di lavoro contenente dati deve essere dedotta leggendo il foglio di lavoro, anziché leggendo i metadati delle dimensioni dal file. Ciò può essere utile nei casi in cui i metadati delle dimensioni non sono corretti. Si noti che questa opzione è supportata solo per i file di Excel Open XML, non per i file di Excel legacy. Valore predefinito: false.

Nota

Il parametro useHeaders o il campo di record UseHeaders converte numeri e date in testo usando la cultura corrente e quindi si comporta in modo diverso quando viene eseguito in ambienti con culture impostate diversamente. È consigliabile usare invece Table.PromoteHeaders. Ad esempio, invece di usare Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) o Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null)), usare invece Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])).

Esempio 1

Restituisce il contenuto del Foglio 1 da una cartella di lavoro di Excel.

Utilizzo

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

Output

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