Excel.Workbook

Syntaksi

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

Noin

Palauttaa Excel-työkirjan sisällön.

• useHeaders voi olla tyhjäarvo, looginen arvo (true/false), joka ilmaisee, käsitelläänkö jokaisen palautetun taulukon ensimmäistä riviä otsikkona vai asetustietueena. Oletusarvo: false.
• delayTypes voi olla tyhjäarvo tai looginen arvo (tosi/epätosi), joka ilmaisee, tuleeko jokaisen palautetun taulukon sarakkeet jättää tyypittömäksi. Oletusarvo: false.

Jos useHeaders on määritetty tietue (ja delayTypes on tyhjäarvo), voidaan antaa seuraavat tietuekentät:

• UseHeaders: Voi olla tyhjäarvo tai looginen arvo (tosi/epätosi), joka ilmaisee, käsitelläänkö jokaisen palautetun taulukon ensimmäistä riviä otsikkona. Oletusarvo: false.
• DelayTypes: Voi olla tyhjäarvo tai looginen arvo (tosi/epätosi), joka ilmaisee, tuleeko jokaisen palautetun taulukon sarakkeet jättää tyypittömäksi. Oletusarvo: false.
• InferSheetDimensions: Voi olla tyhjäarvo tai looginen arvo (tosi/epätosi), joka ilmaisee, tuleeko tietoja sisältävän laskentataulukon alue päätellä lukemalla laskentataulukkoa sen sijaan, että se lukisi dimensioiden metatiedot tiedostosta. Tästä voi olla hyötyä tapauksissa, joissa dimensioiden metatiedot ovat virheellisiä. Huomaa, että tätä asetusta tuetaan vain Excelin Open XML -tiedostoissa, ei vanhoissa Excel-tiedostoissa. Oletusarvo: false.

Muistiinpano

useHeaders-parametri tai UseHeaders -tietuekenttä muuntaa luvut ja päivämäärät tekstiksi käyttäen nykyistä maa-asetusta ja käyttäytyy siten eri tavalla, kun sitä suoritetaan ympäristöissä, joissa on määritetty eri käyttöjärjestelmän maa-asetus. Suosittelemme sen sijaan Table.PromoteHeaders käyttöä. Käytä esimerkiksi Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) tai Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null))käyttämisen sijaan Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])).

Esimerkki 1

Palauta Excel-työkirjan Sheet1-taulukon sisältö.

käyttö

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