Méthodes du connecteur Microsoft Excel

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 13 minutes de lecture
  • Les Microsoft méthodes du connecteur Excel effectuent diverses actions sur Microsoft les documents Excel. Dans un flux d’automatisation, les méthodes sont connectées à d’autres méthodes et composants. Pour utiliser les méthodes, vous devez d’abord les exposer.

    Ouvert

    Crée ou ouvre un fichier existant Microsoft en fonction des entrées.
    Remarque :
    Vous devez exécuter cette méthode avant toute autre méthode.
    Tableau 1. Paramètres de méthode ouverte
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Chemin d’accès au fichier

    Chemin d’accès au fichier existant que la méthode ouvre.

    Pour créer un fichier, vous devez définir la valeur du paramètre CreateNewFile sur True.

    Remarque :
    Le chemin d’accès doit contenir le nom du fichier.
    Données dans Chaîne Aucun Oui
    Créer un nouveau fichier Crée un fichier.

    Pour créer un fichier, définissez la valeur sur Vrai et indiquez le chemin d’accès et le nom de fichier dans le paramètre Chemin d’accès au fichier.

    Données dans Booléen Aucun Non
    DisplayAlerts (en anglais seulement) Affiche une alerte dans la barre des tâches lorsqu’un fichier est ouvert ou créé.

    Pour afficher une alerte, définissez la valeur sur True, puis la valeur du paramètre IsVisible sur True.

    Données dans Booléen Aucun Non
    Est visible Fonctionne avec le paramètre DisplayAlerts pour afficher une alerte dans la barre des tâches lorsqu’un fichier est ouvert ou créé.

    Pour afficher une alerte, définissez la valeur sur True, puis la valeur du paramètre DisplayAlerts sur True.

    Données dans Booléen Aucun Non
    ReadOnlyMode (en anglais seulement) Si la valeur est True, la méthode ouvre le fichier en mode lecture seule, sinon, ouvre le fichier en mode modifiable. Données dans Booléen Aucun Non
    Mot de passe Utilisez un mot de passe si le document est protégé par un mot de passe. Données dans Chaîne Aucun Non
    Retour Si la valeur est Vrai, le fichier est ouvert ou créé, sinon la valeur est Faux. Sortie de données Booléen Non applicable Non applicable

    AjouterNouveauFeuille de travail

    Ajoute une feuille de calcul au fichier.
    Remarque :
    Vous devez exécuter la méthode Open avant d’exécuter cette méthode.
    Tableau 2. Paramètres de méthode AddNewWorkSheet
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul que la méthode ajoute au fichier. Données dans Chaîne Aucun Oui

    GetSheetNames (en anglais seulement)

    Renvoie les noms des feuilles dans le document Excel ouvert Microsoft .
    Remarque :
    Vous devez exécuter la méthode Open avant d’exécuter cette méthode.
    Tableau 3. Paramètres de méthode GetSheetNames
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie les noms des feuilles dans le document Excel ouvert Microsoft . Sortie de données Chaîne Aucune valeur par défaut Non applicable

    Fermer

    Ferme le document Excel actif Microsoft .
    Remarque :
    Vous devez exécuter la méthode Open avant d’exécuter cette méthode.
    Tableau 4. Paramètres de la méthode de fermeture
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    saveChanges Si la valeur est définie sur Vrai, les changements apportés au fichier sont enregistrés avant la fermeture. Sinon, si la valeur est définie sur Faux, aucun changement n’est enregistré. Données dans Booléen Aucun Non

    Nombre de colonnes

    Renvoie le nombre total de colonnes dans une feuille de calcul du fichier Excel actif Microsoft .
    Remarque :
    Vous devez exécuter la méthode Open avant d’exécuter cette méthode.
    Tableau 5. Paramètres de la méthode ColumnsCount
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille que la méthode utilise pour compter le nombre de colonnes. Données dans Chaîne Aucun Oui
    Retour Renvoie le nombre de colonnes dans la feuille de calcul. Sortie de données Entier Non applicable Non applicable

    Copier

    Copie le contenu d’une plage de cellules dans une feuille de calcul.
    Conseil :
    Vous pouvez coller les contenus copiés à l’aide de la méthode Coller.
    Tableau 6. Copier les paramètres de la méthode
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille à partir de laquelle la méthode copie le contenu de la cellule. Données dans Chaîne Aucun Oui
    Plage cellulaire Plage de cellules à partir desquelles la méthode copie le contenu. Données dans Chaîne Aucun Oui

    Graphique créé

    Crée le type de graphique spécifié sur le document Excel ouvert Microsoft .
    Remarque :
    Vous devez exécuter la méthode Open avant celle-ci.
    Tableau 7. Paramètres de méthode CreateChart
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille sur laquelle le graphique est créé. Données dans Chaîne Aucune valeur par défaut Oui
    Plage cellulaire Plage de cellules à partir desquelles la méthode prend les données pour créer un graphique. Données dans Chaîne Aucune valeur par défaut Oui
    Type de graphique Type de graphique qui sera créé. Données dans ExcelChartType Aucune valeur par défaut Oui
    Retour Si la valeur est Vrai, le graphique a été créé avec succès. Sinon, si la valeur est Faux, la création du graphique a échoué. Sortie de données Booléen Aucune valeur par défaut Non applicable

    Colonne de suppression

    Supprime une colonne en fonction de l’index spécifié.

    Tableau 8. Paramètres de la méthode DeleteColumn
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille à partir de laquelle la colonne est supprimée. Données dans Chaîne Aucune valeur par défaut Oui
    Index de colonne Index de la colonne que la méthode supprimera. Données dans Entier Aucune valeur par défaut Oui
    Retour Renvoie la valeur booléenne qui indique si la colonne est supprimée. Si la valeur est Vrai, la colonne est supprimée. Sinon, si la valeur est Faux, la colonne n’a pas été supprimée. Sortie de données Booléen Non applicable Non applicable

    DeleteContentFromRange (en anglais seulement)

    Supprime le contenu de la plage de cellules spécifiée.

    Tableau 9. Paramètres de méthode DeleteContentFromRange
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille à partir de laquelle le contenu sera supprimé. Données dans Chaîne Aucune valeur par défaut Oui
    Plage cellulaire Plage de cellules sous la colonne. Données dans Chaîne Aucune valeur par défaut Oui
    Retour Renvoie la valeur booléenne indiquant si les contenus ont été supprimés. Sortie de données Booléen Non applicable Non applicable

    DeleteEmptyColumns (Supprimer les colonnes vides)

    Supprime les colonnes sans contenu.

    Tableau 10. Paramètres de méthode DeleteEmptyColumns
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille contenant la colonne vide. Données dans Chaîne Aucune valeur par défaut Oui

    DeleteEmptyRows (en anglais seulement)

    Supprime les lignes vides de la feuille de calcul spécifiée.

    Tableau 11. Paramètres de méthode DeleteEmptyColumns
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille contenant les lignes vides. Données dans Chaîne Aucune valeur par défaut Oui

    Ligne de suppression

    Supprime la ligne en fonction de l’index spécifié.

    Tableau 12. Paramètres de la méthode DeleteRow
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille à partir de laquelle les lignes seront supprimées. Données dans Chaîne Aucune valeur par défaut Oui
    Index de ligne Index de la ligne qui sera supprimée. Données dans Entier Aucune valeur par défaut Oui
    Retour Renvoie la valeur booléenne qui indique si la ligne a été supprimée. Sortie de données Booléen Non applicable Non applicable

    Supprimer la feuille de travail

    Supprime la feuille de calcul spécifiée.

    Tableau 13. Paramètres de méthode DeleteWorksheet
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille qui sera supprimée. Données dans Chaîne Aucune valeur par défaut Oui
    Retour Renvoie la valeur booléenne qui indique si la feuille de calcul a été supprimée. Sortie de données Booléen Non applicable Non applicable

    Exporter des graphiques en tant qu’images

    Exporte le graphique de la feuille de calcul spécifiée sous forme d’image vers l’emplacement spécifié.

    Tableau 14. Paramètres de méthode ExportChartAsImages
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille qui contient le graphique. Données dans Chaîne Aucune valeur par défaut Oui
    Chemin d’accès du dossier à enregistrer Chemin d’accès au lecteur local où le graphique sera enregistré. Données dans Chaîne Aucune valeur par défaut Non applicable

    ExportToPDF

    Exporte le contenu du document Excel ouvert au format PDF.

    Tableau 15. Paramètres de méthode ExportChartAsImages
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Chemin d’accès au fichier Chemin vers le lecteur local où le PDF est exporté. Données dans Chaîne Aucune valeur par défaut Oui

    TrouverEtRemplacer

    Recherche et remplace le texte dans la feuille de calcul spécifiée.

    Tableau 16. Paramètres de la méthode FindAndReplace
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul dans laquelle le texte sera remplacé. Données dans Chaîne Aucune valeur par défaut Oui
    Texte de recherche Texte qui sera remplacé. Données dans Chaîne Aucune valeur par défaut Oui
    Remplacer par Texte qui remplacera le texte existant. Données dans Chaîne Aucune valeur par défaut Oui
    Retour Renvoie la valeur booléenne qui indique si le texte a été remplacé. Sortie de données Booléen Non applicable Non applicable

    GetActiveSheetName (en anglais seulement)

    Renvoie le nom de la feuille de calcul active.

    Tableau 17. Paramètres de méthode GetActiveSheetName
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie le nom de la feuille de calcul active. Sortie de données Chaîne Aucune valeur par défaut Non applicable

    InsérerNouvelle colonne

    Insère une nouvelle colonne à l’index spécifié dans la feuille de calcul.

    Tableau 18. Paramètres de la méthode InsertNewColumn
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul dans laquelle la colonne sera insérée. Données dans Chaîne Aucune valeur par défaut Oui
    Index de colonne Index de la nouvelle colonne. La nouvelle colonne sera insérée à l’index spécifié. Données dans Entier Aucune valeur par défaut Oui

    Insérer une nouvelle ligne

    Insère une nouvelle ligne à l’index spécifié dans la feuille de calcul spécifiée.

    Tableau 19. Paramètres de la méthode InsertNewRow
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul dans laquelle la ligne sera insérée. Données dans Chaîne Aucune valeur par défaut Oui
    Index de ligne Index de la ligne. La ligne sera insérée à l’index spécifié. Données dans Entier Aucune valeur par défaut Oui
    Retour Renvoie la valeur booléenne qui indique si une ligne a été insérée. Si la valeur est Vrai, la ligne a été insérée. Sinon, si la valeur est Faux, la ligne n’a pas été insérée. Sortie de données Booléen Non applicable Non applicable

    Insérer un objet

    Insère un objet dans la cellule spécifiée d’une feuille d’un fichier Excel. Un exemple d’objet peut être un fichier Excel, une image ou un fichier PDF.
    Remarque :
    Exécutez la méthode Open avant d’exécuter cette méthode.
    Tableau 20. Paramètres de méthode InsertObject
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Feuille Excel qui contient la cellule dans laquelle la méthode insère l’objet. Données dans Chaîne N/A Oui
    Nom de cellule Nom de la cellule dans laquelle la méthode insère l’objet. Par exemple, A1. Données dans Chaîne N/A Oui
    Chemin d’accès au fichier Chemin d’accès au fichier de l’objet que la méthode insère. Données dans Chaîne N/A Oui

    IsOpen

    Renvoie la valeur booléenne indiquant si le fichier Excel spécifié est ouvert.

    Tableau 21. Paramètres de la méthode IsOpen
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Chemin d’accès au fichier Chemin d’accès au fichier Excel dans le lecteur local. Données dans Chaîne Aucune valeur par défaut Oui
    Retour Renvoie la valeur booléenne qui indique si le fichier Excel est ouvert. Sortie de données Booléen Non applicable Non applicable

    MergeCells (Fusionner les cellules)

    Fusionne les cellules spécifiées dans la plage.

    Tableau 22. Paramètres de la méthode MergeCells
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul sur laquelle les cellules seront fusionnées. Données dans Chaîne Aucune valeur par défaut Oui
    Plage cellulaire Plage de cellules. Toutes les cellules de la plage seront fusionnées. Données dans Chaîne Aucune valeur par défaut Oui

    ReadFromRange (Plage de lecture)

    Lit les données de la feuille de calcul spécifiée et renvoie les données.

    Tableau 23. Paramètres de méthode ReadFromRange
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul à partir de laquelle la méthode lira les données. Données dans Chaîne Aucune valeur par défaut Oui
    Plage cellulaire Plage de cellules. La méthode lira les données de ces cellules. Données dans Chaîne Aucune valeur par défaut Oui
    FirstRowAsHeader (en anglais seulement) Valeur booléenne qui indique si la méthode traite la première ligne comme en-tête. Si la valeur est vrai, la première ligne est traitée comme un en-tête. Sinon, si la valeur est faux, elle ne traite pas la première ligne comme un en-tête. Données dans Booléen Aucune valeur par défaut Non
    Retour Renvoie la table de données qui comprend les données des cellules. Sortie de données Table de données Non applicable Non

    ReadFromSheet (Lire) à partir de la feuille

    Renvoie toutes les données de la feuille de calcul spécifiée.

    Tableau 24. Paramètres de la méthode MergeCells
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul à partir de laquelle la méthode lira les données. Données dans Chaîne Aucune valeur par défaut Oui
    Retour Renvoie toutes les données de la feuille de calcul spécifiée. Sortie de données Table de données Non applicable Non applicable

    RenommerFeuilleNom

    Renomme une feuille de calcul existante.

    Tableau 25. Paramètres de méthode RenameSheetName
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    OldSheetName (Ancien) Nom de la feuille Nom de la feuille de calcul existante. Données dans Chaîne Aucune valeur par défaut Oui
    NewSheetName (en anglais seulement) Nouveau nom de la feuille de calcul. Données dans Chaîne Aucune valeur par défaut Oui
    Retour Renvoie la réponse booléenne qui indique si la feuille de calcul a été renommée. Sortie de données Booléen Aucune valeur par défaut Non applicable

    Nombre de lignes

    Renvoie le nombre de lignes dans la feuille de calcul spécifiée.

    Tableau 26. Paramètres de méthode RenameSheetName
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul à partir de laquelle le nombre de lignes sera renvoyé. Données dans Chaîne Aucune valeur par défaut Oui
    Retour Renvoie le nombre de lignes. Sortie de données Entier Non applicable Non applicable

    SupprimerFiltre

    Supprime tous les filtres définis dans le document Excel.

    Tableau 27. Paramètres de la méthode RemoveFilter
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul à partir de laquelle la méthode supprimera les filtres. Données dans Chaîne Aucune valeur par défaut Oui

    Enregistrer

    Enregistre les changements apportés au document Excel.

    WriteToRange (en anglais seulement)

    Écrit les données dans une plage spécifiée.

    Tableau 28. Paramètres de la méthode RemoveFilter
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom de la feuille Nom de la feuille de calcul sur laquelle les données sont écrites. Données dans Chaîne Aucune valeur par défaut Oui
    Nom de cellule Nom de la cellule sur laquelle les données sont écrites. Données dans Chaîne Aucune valeur par défaut Oui
    Données Données qui seront écrites. Données dans Table de données Aucune valeur par défaut Oui
    En-têtes d’inclusion Valeur booléenne qui indique si les en-têtes de la table de données seront ajoutés. Données dans Booléen Aucune valeur par défaut Non