Catégories
Visual Studio

Comment renommer un projet Visual Studio et son dossier

Il peut arriver d’avoir à renommer un projet sous Visual Studio (VS) pour par exemple se conformer à une nouvelle convention de nommage ou pour en adopter une nouvelle. Nous allons voir dans cet article comment renommer un Namespace en apportant les modifications suivantes dans :

  • le projet Visual Studio
  • les fichiers faisant référence au Namespace
  • le dossier du projet (dans l’explorateur Windows)

Modification du projet Visual Studio

Il faut commencé par modifier le projet VS lui même (les paramètres du projet), pour cela :

  • sélectionner le nom du projet
  • faites un « ALT + Entrée » pour ouvrir la fenêtre des Propriétés du Projet
  • dans l’onglet Application modifier les champs « Assembly name » et « Default namespace »
  • pour finir, remplacer (attention c’est dangereux) toutes les références à votre namespace précédent dans votre projet par le nouveau namespace (si vous avez des projets annexe, ne les oubliez pas) en suivant les étapes suivantes.

Find & Replace

Une fois le projet Visual Studio modifié, il faut effectuer un remplacement de l’ancien namespace par le nouveau dans vos fichiers :

  • Effectuer une recherche, pour pré-visualiser vos modifications
    • effectuer un « CTRL + SHIFT + F« 
    • entrez le nom de votre ancien namespace
    • sélectionner le « scope » de votre recherche (niveau de votre Solution, du Projet, ou des fichiers ouverts)
    • Parcourez attentivement les résultats à la recherche de « faux positifs »
  • Une fois que la recherche est suffisamment précise pour valider la liste des fichiers à modifier, ouvrir la boite de dialogue de remplacement effectuer un « CTRL + SHIFT + H« , puis faites de même en précisant cette fois le nouveau namespace (namespace cible) dans le champ « Replace with« .
  • Si vous êtes sure de votre coup, faites un « Replace All« ,
    il vous restera encore une chance de revenir en arrière car tous les fichiers modifiés seront ouvert dans de nouveaux onglets, et ces remplacements doivent à être sauvegardés « CTRL + SHIFT + S« 
    A ce stade, votre projet et fichiers ont été modifiés à l’intérieur de Visual Studio à l’exception d’un endroit, nous y reviendrons à la fin)

Renommage du dossier

Si vous utilisez un gestionnaire de version comme TFS ou Git, il vous faudra peut être effectuer les étapes ci-dessous à travers votre gestionnaire de source directement 🙂

Une fois le tout sauvegardé, ouvrir et renommer dans l’explorateur Windows le dossier de votre projet, ou depuis Visual Studio faire un clic droit sur le nom du projet à renommer et sélectionner dans la liste : Open Folder in Windows Explorer > fermer Visual Studio > renommer le dossier dans l’explorateur Windows ouvert précédemment.

ré-ouvrir votre Solution et vous constaterez que le nom de votre projet est grisé (inaccessible car Visual Studio référence encore l’ancien dossier)

  • sélectionner votre nom de projet grisé, puis au clavier faites un « ALT + Entrée » pour modifier le champs « File path »
  • pour finir, effectuer un clic droit sur le projet toujours grisé, et « Reload Project »

Cet article a été inspiré d’un post sur Stack Overflow