Méthode Workbooks.Open (Excel)
Ouvre un classeur.
Remarque
Vous voulez développer des solutions qui étendent l’expérience Office sur plusieurs plateformes ? Découvrez le nouveau modèle de compléments Office. Les compléments Office ont un encombrement réduit par rapport aux compléments et solutions VSTO. Vous pouvez les créer à l’aide de pratiquement n’importe quelle technologie de programmation web, telle que HTML5, JavaScript, CSS3 et XML.
Syntaxe
expression.Ouvrir (FileName, UpdateLinks, ReadOnly, Format, Mot de passe, WriteResPassword, IgnoreReadOnlyReend, Cellule, Délimiteur, Modifiable, Notification, Convertisseur, AddToMru, Local, CorruptLoad)
expression Variable qui représente un objet Workbooks.
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| FileName | Facultatif | Variant | String. Nom de fichier du classeur à ouvrir. |
| UpdateLinks | Facultatif | Variant | Spécifie la façon dont les références externes (liens) du fichier, telles que la référence à une plage du classeur Budget.xls dans la formule =SUM([Budget.xls]Annual!C10:C25), sont mises à jour. Si cet argument est omis, l’utilisateur est invité à indiquer comment les liens doivent être mis à jour. Pour plus d’informations sur les valeurs utilisées par ce paramètre, voir la section Remarques.Si Microsoft Excel ouvre un fichier au format WKS, WK1 ou WK3 et si l’argument UpdateLinks a la valeur 0, aucun graphique n’est créé ; sinon, Microsoft Excel crée des graphiques à partir des diagrammes associés au fichier. |
| ReadOnly | Facultatif | Variant | True pour ouvrir le classeur en mode lecture seule. |
| Format | Facultatif | Variant | Si Microsoft Excel ouvre un fichier texte, cet argument spécifie le caractère délimiteur. Si cet argument n'est pas défini, le délimiteur en cours est utilisé. Pour plus d'informations sur les valeurs utilisées par ce paramètre, consultez la section Remarques. |
| Password | Facultatif | Variant | Chaîne contenant le mot de passe requis pour ouvrir un classeur protégé. Si cet argument n'est pas défini et que le classeur requiert un mot de passe, l'utilisateur est invité à entrer le mot de passe |
| WriteResPassword | Facultatif | Variant | Chaîne contenant le mot de passe requis pour écrire dans un classeur protégé en écriture. Si cet argument n'est pas défini et que le classeur requiert un mot de passe, l'utilisateur est invité à entrer le mot de passe |
| IgnoreReadOnlyRecommended | Facultatif | Variant | True pour que Microsoft Excel n'affiche pas le message en lecture seule recommandée (si le classeur a été enregistré avec l'option Lecture seule recommandée). |
| Cellule | Facultatif | Variant | S’il s’agit d’un fichier texte, cet argument indique sa provenance, de sorte que les pages de code et les retours chariot/sauts de ligne (CR/LF) puissent être mappés correctement. Il peut s'agir de l’une des constantes XlPlatform suivantes : XlMacintosh, XlWindows ou XlMSDOS. Si cet argument est omis, le système d’exploitation actuel est utilisé. |
| Délimiteur | Facultatif | Variant | S’il s’agit d’un fichier texte et que l’argument Format a la valeur 6, cet argument est une chaîne qui spécifie le caractère à utiliser comme délimiteur. Par exemple, utilisez Chr(9) pour les tabulations, « , » pour les virgules, « ; » pour les point-virgules, ou utilisez un caractère personnalisé. Seul le premier caractère de la chaîne est utilisé. |
| Editable (Modifiable) | Facultatif | Variant | Si le fichier est une macro complémentaire Microsoft Excel 4.0, cet argument a la valeur True pour ouvrir la macro complémentaire de sorte qu'elle soit une fenêtre visible. Si cet argument a la valeur False ou n'est pas défini, la macro complémentaire est ouverte masquée, et ne peut pas être affichée. Cette option ne s'applique pas aux compléments créés dans Microsoft Excel 5.0 ou version ultérieure. Si le fichier est un modèle Excel, la valeur True ouvre le modèle spécifié pour modification. La valeur False ouvre un nouveau classeur basé sur le modèle spécifié. La valeur par défaut est False. |
| Notification | Facultatif | Variant | Si le fichier ne peut pas être ouvert en mode lecture-écriture, cet argument a la valeur True pour ajouter le fichier à la liste de notification des fichiers. Microsoft Excel ouvre le fichier en lecture seule, interroge la liste de notification des fichiers, puis avertit l’utilisateur quand le fichier devient disponible. Si cet argument a la valeur False ou n'est pas défini, aucune notification n’est requise, et toute tentative d’ouverture d’un fichier indisponible échoue. |
| Convertisseur | Facultatif | Variant | Index du premier convertisseur de fichiers à essayer lors de l’ouverture du fichier. Le convertisseur de fichiers spécifié est tenté en premier. Si ce convertisseur ne reconnaît pas le fichier, tous les autres convertisseurs sont tentés. L’index du convertisseur est constitué des numéros de ligne des convertisseurs renvoyés par la propriété FileConverters. |
| AddToMru | Facultatif | Variant | True pour ajouter ce classeur à la liste des derniers fichiers utilisés. La valeur par défaut est False. |
| Local | Facultatif | Variant | True enregistre les fichiers par rapport à la langue de Microsoft Excel (y compris les paramètres du Panneau de configuration). False (valeur par défaut) enregistre les fichiers par rapport à la langue de Visual Basic pour Applications (VBA) (Il s’agit généralement de l’anglais des États-Unis, sauf si le projet VBA à partir duquel Workbooks.Open est exécuté est un ancien projet VBA XL5/95 internationalisé). |
| CorruptLoad | Facultatif | XlCorruptLoad | Peut être l’une des constantes suivantes : xlNormalLoad, xlRepairFile et xlExtractData. Le comportement par défaut si aucune valeur n’est spécifiée est xlNormalLoadet ne tente pas de récupération lorsqu’il est initié via l’OM. |
Valeur renvoyée
Objet Classeur qui représente le classeur ouvert.
Remarques
Par défaut, les macros sont activées lors de l'ouverture des fichiers par programmation. Utilisez la propriété AutomationSecurity pour définir le mode de sécurité des macros à utiliser dans ce cas.
Vous pouvez spécifier une des valeurs suivantes dans le paramètre UpdateLinks pour déterminer si les références externes (liens) sont mises à jour lors de l'ouverture d'un classeur.
| Valeur | Description |
|---|---|
| 0 | Les références externes (liens) ne sont pas mises à jour à l’ouverture du classeur. |
| 3 | Les références externes (liens) sont mises à jour à l’ouverture du classeur. |
Vous pouvez spécifier l'une des valeurs suivantes dans le paramètre Format afin de déterminer le caractère séparateur pour le fichier.
| Valeur | Délimiteur |
|---|---|
| 1 | Tabulation |
| 2 | Virgule |
| 3 | Espace |
| 4 | Point-virgule |
| 5 | Aucun |
| 6 | Caractère personnalisé (voir l'argument Délimiteur) |
Exemple
L'exemple de code suivant ouvre le classeur Analysis.xls, puis exécute sa macro Auto_Open.
Workbooks.Open "ANALYSIS.XLS"
ActiveWorkbook.RunAutoMacros xlAutoOpen
L'exemple de code suivant importe une feuille à partir d'un autre classeur dans une nouvelle feuille du classeur actif. La feuille Sheet1 du classeur actif doit contenir le chemin d'accès du classeur à importer dans la cellule D3, le nom de fichier dans la cellule D4 et le nom de la feuille de calcul dans la cellule D5. La feuille de calcul importée est insérée après Sheet1 dans le classeur actif.
Sub ImportWorksheet()
' This macro will import a file into this workbook
Sheets("Sheet1").Select
PathName = Range("D3").Value
Filename = Range("D4").Value
TabName = Range("D5").Value
ControlFile = ActiveWorkbook.Name
Workbooks.Open Filename:=PathName & Filename
ActiveSheet.Name = TabName
Sheets(TabName).Copy After:=Workbooks(ControlFile).Sheets(1)
Windows(Filename).Activate
ActiveWorkbook.Close SaveChanges:=False
Windows(ControlFile).Activate
End Sub
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.