Méthode Workbooks.Open (Excel)

Article
04/07/2023

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.