Lezen in het Engels

Delen via


Excel.Workbook

Syntaxis

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

Over

Retourneert de inhoud van de Excel-werkmap.

  • useHeaders kan null zijn, een logische waarde (waar/onwaar) die aangeeft of de eerste rij van elke geretourneerde tabel moet worden behandeld als een koptekst of een optiesrecord. Standaard: onwaar.
  • delayTypes kan null of een logische waarde (waar/onwaar) zijn die aangeeft of de kolommen van elke geretourneerde tabel niet moeten worden getypt. Standaard: false.

Als er een record is opgegeven voor useHeaders (en delayTypes null is), kunnen de volgende recordvelden worden opgegeven:

  • UseHeaders: kan null zijn of een logische waarde (waar/onwaar) die aangeeft of de eerste rij van elke geretourneerde tabel moet worden behandeld als een koptekst. Standaard: false.
  • DelayTypes: kan null zijn of een logische waarde (waar/onwaar) die aangeeft of de kolommen van elke geretourneerde tabel niet moeten worden getypt. Standaard: onwaar.
  • InferSheetDimensions: kan null of een logische waarde (waar/onwaar) zijn die aangeeft of het gebied van een werkblad met gegevens moet worden afgeleid door het werkblad zelf te lezen in plaats van de metagegevens van de dimensies uit het bestand te lezen. Dit kan handig zijn in gevallen waarin de metagegevens van dimensies onjuist zijn. Houd er rekening mee dat deze optie alleen wordt ondersteund voor Open XML Excel-bestanden, niet voor verouderde Excel-bestanden. Standaard: onwaar.

Notitie

De parameter useHeaders of het UseHeaders recordveld converteert getallen en datums naar tekst met behulp van de huidige cultuur en gedraagt zich dus anders wanneer deze worden uitgevoerd in omgevingen met verschillende culturen van besturingssystemen. U wordt aangeraden in plaats daarvan Table.PromoteHeaders te gebruiken. Gebruik bijvoorbeeld Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])) in plaats van Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) of Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null))te gebruiken.

Voorbeeld 1

De inhoud van Blad1 retourneren vanuit een Excel-werkmap.

Gebruik

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

uitvoer

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