Procédure pas à pas : appeler du code VBA dans un projet Visual C#
Cette procédure pas à pas montre comment appeler une méthode dans une personnalisation au niveau du document pour Microsoft Office Excel à partir du code VBA (Visual Basic pour Applications) du classeur. Cette procédure comporte trois étapes de base : l'ajout d'une méthode dans la classe d'élément hôte Sheet1
, l'exposition de la méthode au code VBA dans le classeur, puis l'appel de la méthode à partir du code VBA dans le classeur.
S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document pour Excel et Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.
Bien que cette procédure pas à pas utilise spécifiquement Excel, les concepts présentés ici s'appliquent également aux projets de niveau document pour Word.
Cette procédure pas à pas décrit les tâches suivantes :
Création d'un classeur contenant du code VBA
Approbation de l'emplacement du classeur à l'aide du Centre de gestion de la confidentialité dans Excel
Ajout d'une méthode à la classe d'élément hôte
Sheet1
Extraction d'une interface pour la classe d'élément hôte
Sheet1
Exposition de la méthode au code VBA.
Appel de la méthode à partir du code VBA
Notes
Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE Visual Studio.
Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :
Une édition de Visual Studio qui inclut les outils de développement Microsoft Office. Pour plus d’informations, consultez Configurer un ordinateur pour développer des solutions Bureau.
Microsoft Excel
La première étape consiste à créer un classeur prenant en charge les macros et contenant une macro VBA simple. Avant d'exposer le code d'une personnalisation à VBA, le classeur doit déjà contenir du code VBA. Dans le cas contraire, Visual Studio ne peut pas modifier le projet VBA pour permettre au code VBA d'appeler l'assembly de personnalisation.
Si vous disposez déjà d'un classeur contenant du code VBA que vous souhaitez utiliser, vous pouvez ignorer cette étape.
Démarrez Excel.
Enregistrez le document actif sous la forme d’un classeur avec macro Excel (*.xlsm) avec le nom WorkbookWithVBA. dans un emplacement approprié, tel que le Bureau.
Dans le ruban, cliquez sur l'onglet Développeur .
Notes
Si l'onglet Développeur n'est pas visible, vous devez tout d'abord l'afficher. Pour plus d’informations, consultez Guide pratique pour afficher l’onglet Développeur du ruban.
Dans le groupe Code , cliquez sur Visual Basic.
Visual Basic Editor s'ouvre.
Dans la fenêtre Projet , double-cliquez sur ThisWorkbook.
Le fichier de code de l'objet
ThisWorkbook
s'ouvre.Ajoutez le code VBA suivant au fichier de code. Ce code définit une fonction simple qui ne fait rien. Le seul objectif de cette fonction consiste à s'assurer qu'un projet VBA existe dans le classeur. Cela est nécessaire pour les étapes ultérieures de cette procédure.
Sub EmptySub() End Sub
Enregistrez le document et quittez Excel.
Vous pouvez maintenant créer un projet au niveau du document pour Excel qui utilise le classeur prenant en charge les macros que vous avez créé précédemment.
Démarrez Visual Studio.
Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.
Dans le volet Modèles, développez Visual C#puis Office/SharePoint.
Sélectionnez le nœud Compléments Office .
Dans la liste des modèles de projet, sélectionnez le projet Classeur Excel 2010 ou Classeur Excel 2013 .
Dans la zone Nom , tapez AppelCodeDeVBA.
Cliquez sur OK.
L' Assistant Projet Visual Studio Tools pour Office s'ouvre.
Sélectionnez Copier un document existant, puis, dans la zone Chemin d'accès complet du document existant , spécifiez l'emplacement du classeur ClasseurAvecVBA que vous avez créé précédemment. Si vous utilisez votre propre classeur prenant en charge les macros, spécifiez l'emplacement de ce classeur à la place.
Cliquez sur Terminer.
Visual Studio ouvre le classeur WorkbookWithVBA dans le concepteur et ajoute le projet CallingCodeFromVBA à Explorateur de solutions.
Avant d'exposer le code dans votre solution au code VBA dans le classeur, vous devez approuver VBA dans le classeur à exécuter. Il existe plusieurs manières de procéder. Dans le cas présent, vous allez effectuer cette tâche en approuvant l'emplacement du classeur dans le Centre de gestion de la confidentialité d'Excel.
Démarrez Excel.
Cliquez sur l'onglet Fichier .
Cliquez sur le bouton Options Excel .
Dans le volet des catégories, cliquez sur Centre de gestion de la confidentialité.
Dans le volet d'informations, cliquez sur Paramètres du Centre de gestion de la confidentialité.
Dans le volet des catégories, cliquez sur Emplacements approuvés.
Dans le volet d'informations, cliquez sur Ajouter un nouvel emplacement.
Dans la boîte de dialogue Emplacement approuvé de Microsoft Office , accédez au dossier qui contient le projet AppelCodeDeVBA .
Sélectionnez Les sous-dossiers de cet emplacement sont également approuvés.
Dans la boîte de dialogue Emplacement approuvé de Microsoft Office , cliquez sur OK.
Dans la boîte de dialogue Centre de gestion de la confidentialité , cliquez sur OK.
Dans la boîte de dialogue Options Excel , cliquez sur OK.
Quittez Excel.
Maintenant que le projet VBA est configuré, ajoutez une méthode publique à la classe d'élément hôte Sheet1
que vous pouvez appeler à partir du code VBA.
Dans l' Explorateur de solutions, cliquez avec le bouton droit sur Sheet1.cs, puis cliquez sur Afficher le code.
Le fichier Sheet1.cs s'ouvre dans l'éditeur de code.
Ajoutez le code suivant à la classe
Sheet1
. La méthodeCreateVstoNamedRange
crée un nouvel objet NamedRange au niveau de la plage spécifiée. Cette méthode crée également un gestionnaire d'événements pour l'événement Selected de NamedRange. Ultérieurement dans cette procédure, vous appellerez la méthodeCreateVstoNamedRange
à partir du code VBA figurant dans le document.private Microsoft.Office.Tools.Excel.NamedRange namedRange1; public void CreateVstoNamedRange(Excel.Range range, string name) { if (!this.Controls.Contains(name)) { namedRange1 = this.Controls.AddNamedRange(range, name); namedRange1.Selected += new Excel.DocEvents_SelectionChangeEventHandler( namedRange1_Selected); } else { MessageBox.Show("A named range with this specific name " + "already exists on the worksheet."); } } private void namedRange1_Selected(Microsoft.Office.Interop.Excel.Range Target) { MessageBox.Show("This named range was created by Visual Studio " + "Tools for Office."); }
Ajoutez la méthode suivante à la classe
Sheet1
. Cette méthode remplace la méthode GetAutomationObject pour retourner l'instance actuelle de la classeSheet1
.protected override object GetAutomationObject() { return this; }
Appliquez les attributs suivants avant la première ligne de la déclaration de la classe
Sheet1
. Ces attributs rendent la classe visible pour COM, mais ne génèrent pas d'interface de classe.[System.Runtime.InteropServices.ComVisible(true)] [System.Runtime.InteropServices.ClassInterface( System.Runtime.InteropServices.ClassInterfaceType.None)]
Avant d'exposer la méthode CreateVstoNamedRange
au code VBA, vous devez créer une interface publique qui définit cette méthode et l'exposer à COM.
Dans le fichier de code Sheet1.cs , cliquez n'importe où dans la classe
Sheet1
.Dans le menu Refactoriser , cliquez sur Extraire l'interface.
Dans la boîte de dialogue Extraire l'interface , dans la zone Sélectionner des membres publics pour former l'interface , cliquez sur l'entrée correspondant à la méthode
CreateVstoNamedRange
.Cliquez sur OK.
Visual Studio génère une nouvelle interface nommée
ISheet1
et modifie la définition de laSheet1
classe afin qu’elle implémente l’interfaceISheet1
. Visual Studio ouvre également le fichier ISheet1.cs dans l’éditeur de code.Dans le fichier ISheet1.cs , remplacez la déclaration de l'interface
ISheet1
par le code suivant. Ce code rend publique l'interfaceISheet1
et applique l'attribut ComVisibleAttribute pour rendre l'interface visible par COM.[System.Runtime.InteropServices.ComVisible(true)] public interface ISheet1 { void CreateVstoNamedRange(Microsoft.Office.Interop.Excel.Range range, string name); }
Créez le projet.
Pour exposer la méthode CreateVstoNamedRange
au code VBA dans le classeur, affectez la valeur True à la propriété Sheet1
ReferenceAssemblyFromVbaProject pour l'élément hôte.
Dans l' Explorateur de solutions, double-cliquez sur Sheet1.cs.
Le fichier ClasseurAvecVBA s'ouvre dans le concepteur et Sheet1 est visible.
Dans la fenêtre Propriétés , sélectionnez la propriété ReferenceAssemblyFromVbaProject et remplacez sa valeur par True.
Cliquez sur OK dans le message qui s'affiche.
Créez le projet.
Vous pouvez maintenant appeler la méthode CreateVstoNamedRange
à partir du code VBA figurant dans le classeur.
Notes
Dans cette procédure pas à pas, vous allez ajouter du code VBA au classeur lors du débogage du projet. Le code VBA que vous ajoutez à ce document sera remplacé la prochaine fois que vous générerez le projet, car Visual Studio remplace le document dans le dossier de sortie de génération par une copie du document provenant du dossier principal du projet. Si vous souhaitez enregistrer le code VBA, vous pouvez le copier dans le document, dans le dossier du projet. Pour plus d’informations, consultez Combiner des personnalisations au niveau du document et VBA.
Appuyez sur F5 pour exécuter votre projet.
Sous l'onglet Développeur , dans le groupe Code , cliquez sur Visual Basic.
Visual Basic Editor s'ouvre.
Dans le menu Insérer , cliquez sur Module.
Ajoutez le code ci-dessous au nouveau module.
Ce code appelle la méthode
CreateTable
dans l'assembly de personnalisation. La macro accède à cette méthode en utilisant la méthodeGetManagedClass
globale pour accéder à la classe d'élément hôteSheet1
que vous avez exposée au code VBA. La méthodeGetManagedClass
a été générée automatiquement quand vous avez défini la propriété ReferenceAssemblyFromVbaProject , précédemment dans cette procédure pas à pas.Sub CallVSTOMethod() Dim VSTOSheet1 As CallingCodeFromVBA.Sheet1 Set VSTOSheet1 = GetManagedClass(Sheet1) Call VSTOSheet1.CreateVstoNamedRange(Sheet1.Range("A1"), "VstoNamedRange") End Sub
Appuyez sur F5.
Dans le classeur ouvert, cliquez sur la cellule A1 dans Feuil1. Vérifiez que la boîte de message s'affiche.
Quittez Excel sans enregistrer vos modifications.
Pour en savoir plus sur l'appel de code dans les solutions Office à partir de VBA, consultez les rubriques suivantes :
Appeler du code dans un élément hôte dans une personnalisation Visual Basic à partir de VBA. Ce processus est différent du processus Visual C#. Pour plus d’informations, consultez Procédure pas à pas : appeler du code VBA dans un projet Visual Basic.
Appeler du code dans un complément VSTO à partir de VBA. Pour plus d’informations, consultez Procédure pas à pas : appeler du code dans un complément VSTO à partir de VBA.
- Combiner des personnalisations au niveau du document et VBA
- Personnalisations au niveau du document du programme
- Guide pratique pour exposer du code à VBA dans un projet Visual Basic
- Guide pratique pour exposer du code à VBA dans un projet Visual C#
- Procédure pas à pas : appeler du code à partir de VBA dans un projet Visual Basic