Ler em inglês

Partilhar via


Excel.Workbook

Sintaxe

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

Sobre nós

Retorna o conteúdo da pasta de trabalho do Excel.

  • useHeaders pode ser null, um valor lógico (verdadeiro/falso) que indica se a primeira linha de cada tabela retornada deve ser tratada como um cabeçalho ou um registro de opções. Padrão: falso.
  • delayTypes pode ser nulo ou um valor lógico (true/false) indicando se as colunas de cada tabela retornada devem ser deixadas sem tipo. Padrão: falso.

Se um registro for especificado para useHeaders (e delayTypes for null), os seguintes campos de registro podem ser fornecidos:

  • UseHeaders: Pode ser nulo ou um valor lógico (verdadeiro/falso) indicando se a primeira linha de cada tabela retornada deve ser tratada como um cabeçalho. Padrão: falso.
  • DelayTypes: Pode ser nulo ou um valor lógico (verdadeiro/falso) indicando se as colunas de cada tabela retornada devem ser deixadas sem tipo. Padrão: falso.
  • InferSheetDimensions: Pode ser nulo ou um valor lógico (verdadeiro/falso) indicando se a área de uma planilha que contém dados deve ser inferida lendo a própria planilha, em vez de ler os metadados de dimensões do arquivo. Isso pode ser útil nos casos em que os metadados das dimensões estão incorretos. Observe que essa opção só é suportada para arquivos Open XML Excel, não para arquivos herdados do Excel. Padrão: falso.

Nota

O parâmetro useHeaders ou o campo de registro UseHeaders converte números e datas em texto usando a cultura atual e, portanto, se comporta de forma diferente quando executado em ambientes com diferentes culturas de sistema operacional definidas. Em vez disso, recomendamos o uso de Table.PromoteHeaders. Por exemplo, em vez de usar Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) ou Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null)), use Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])) em vez disso.

Exemplo 1

Devolver o conteúdo da Folha1 de uma pasta de trabalho do Excel.

Utilização

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

Saída

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