Partager via


Excel.Workbook

Syntaxe

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

À propos

Retourne le contenu du classeur Excel.

  • useHeaders peut être null, une valeur logique (true/false) indiquant si la première ligne de chaque table retournée doit être traitée comme un en-tête ou un enregistrement d’options. Valeur par défaut : false.
  • delayTypes peut être null ou une valeur logique (true/false) indiquant si les colonnes de chaque table retournée doivent être laissées non typées. Valeur par défaut : false.

Si un enregistrement est spécifié pour useHeaders (et delayTypes est null), les champs d’enregistrement suivants peuvent être fournis :

  • UseHeaders: peut être null ou une valeur logique (true/false) indiquant si la première ligne de chaque table retournée doit être traitée comme un en-tête. Valeur par défaut : false.
  • DelayTypes: peut être null ou une valeur logique (true/false) indiquant si les colonnes de chaque table retournée doivent être laissées non typées. Valeur par défaut : false.
  • InferSheetDimensions: peut être null ou une valeur logique (true/false) indiquant si la zone d’une feuille de calcul qui contient des données doit être déduite en lisant la feuille de calcul elle-même, plutôt qu’en lisant les métadonnées des dimensions du fichier. Cela peut être utile dans les cas où les métadonnées des dimensions sont incorrectes. Notez que cette option est uniquement prise en charge pour les fichiers Excel Open XML, et non pour les fichiers Excel hérités. Valeur par défaut : false.

Note

Le useHeaders paramètre ou le UseHeaders champ d’enregistrement convertit les nombres et les dates en texte à l’aide de la culture actuelle, et se comporte donc différemment lorsqu’il est exécuté dans des environnements avec des cultures de système d’exploitation différentes définies. Nous vous recommandons d’utiliser Table.PromoteHeaders à la place. Par exemple, au lieu d’utiliser Excel.Workbook(File.Contents("C:\myfile.xlsx", true, true)) ou Excel.Workbook(File.Contents("C:\myfile.xlsx", [UseHeaders = true], null)), utilisez Table.PromoteHeaders(Excel.Workbook(File.Contents("C:\myfile.xlsx", null, true), [PromoteAllScalars = true])) à la place.

Exemple 1

Retournez le contenu de la feuille Sheet1 à partir d’un classeur Excel.

Utilisation

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