Procédure pas à pas : conversion d'un projet Web Visual Studio 2002 ou 2003 en projet d'application Web Visual Studio 2008

Mise à jour : novembre 2007

Cette procédure pas à pas décrit comment convertir un projet Visual Studio .NET 2002 ou 2003 en projet d'application Web Visual Studio 2008. Le modèle de projet d'application Web de Visual Studio 2008 est similaire à celui de Visual Studio 2005. Par conséquent, les processus de conversion sont identiques. Pour plus d'informations sur les projets d'application Web, consultez Vue d'ensemble des projets d'application Web.

Vous pouvez également convertir un projet Web Visual Studio .NET en projet de site Web Visual Studio 2008. Toutefois, l'approche prise en charge est la conversion en projet d'application Web, qui fournit des outils pour faciliter la conversion. Par exemple, lorsque vous convertissez un projet en projet d'application Web Visual Studio 2008, vous pouvez utiliser l'Assistant Conversion de Visual Studio pour automatiser une partie du processus. Pour plus d'informations sur la conversion d'un projet Web Visual Studio .NET en site Web Visual Studio 2008, consultez Problèmes courants liés à la conversion de projets Web et leurs solutions (en anglais).

La conversion d'un projet Web Visual Studio 2002 ou 2003 en projet d'application Web Visual Studio 2008 implique deux étapes :

  • Conversion du projet. Vous pouvez utiliser l'Assistant Conversion de Visual Studio pour effectuer la conversion initiale du projet et des fichiers Web.config. Vous pouvez ensuite utiliser la commande Convertir en application Web pour mettre à jour les fichiers et la structure du projet.

  • Mise à niveau de la version du .NET Framework du projet. Vous devez mettre à niveau la version du .NET Framework du projet vers .NET Framework 2.0 SP1 ou .NET Framework 3.5. Cette mise à niveau de la version du .NET Framework est obligatoire car Visual Studio 2008 ne peut pas cibler des versions antérieures du .NET Framework. Vous pouvez effectuer cette mise à niveau pendant la conversion du projet, à l'aide de l'Assistant Conversion. Vous pouvez également mettre à niveau la version du .NET Framework après avoir converti le projet.

    Remarque :

    Vous pouvez modifier manuellement la version du .NET Framework d'un projet. Pour cela, dans Visual Studio, ouvrez les pages de propriétés pour le projet, cliquez sur l'onglet Application,, puis sélectionnez une nouvelle version dans la liste Framework cible.

Cette procédure pas à pas illustre les tâches suivantes :

  • Ouverture du projet Visual Studio .NET dans Visual Studio 2008 et création d'une sauvegarde des fichiers projet.

  • Mise à niveau de la version du .NET Framework ciblée par le projet.

  • Conversion du fichier projet et du fichier Web.config.

  • Conversion de fichiers de code ASP.NET.

  • Test du projet converti.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des éléments suivants :

  • Visual Studio 2008.

  • Un projet de site Web créé dans la version 2002 ou 2003 de Visual Studio .NET qui se compile et s'exécute sans erreur.

Conversion du projet et mise à niveau de la version du .NET Framework

Pour commencer, ouvrez le projet dans Visual Studio 2008. La conversion démarre. Vous avez alors la possibilité de sauvegarder le projet avant de le convertir.

Remarque :

Il est fortement recommandé de sauvegarder le projet. La conversion s'applique sur les fichiers projet d'origine, qui peuvent ne pas être récupérés en cas d'échec de la conversion.

Pour convertir le projet et sauvegarder les fichiers

  1. Dans le menu Fichier de Visual Studio 2008, cliquez sur Ouvrir, puis sur Projet.

    La boîte de dialogue Open Project s'affiche.

  2. Accédez au dossier qui contient le fichier projet ou solution pour le projet Visual Studio .NET, sélectionnez-le, puis cliquez sur Ouvrir.

    Remarque :

    Assurez-vous d'ouvrir le projet à l'aide de la commande Ouvrir un projet. Si vous utilisez la commande Ouvrir le site Web, le projet sera converti au format du projet de site Web.

    L'Assistant Conversion s'ouvre et vous invite à créer une sauvegarde avant de convertir le projet.

  3. Pour créer la sauvegarde, cliquez sur Oui.

  4. Cliquez sur Parcourir, sélectionnez le dossier de sauvegarde, puis cliquez sur Suivant.

  5. Cliquez sur Terminer.

    La sauvegarde démarre.

    Remarque :

    La copie des fichiers peut être relativement longue, sans qu'une progression ou une mise à jour ne soit indiquée. Attendez la fin du processus pour continuer.

    À la fin de la conversion, l'Assistant vous invite à mettre à niveau la version ciblée du .NET Framework pour le projet.

  6. Pour effectuer une mise à niveau vers .NET Framework 3.5, cliquez sur Oui. Pour mettre à niveau le projet pour cibler .NET Framework 2.0 SP1, cliquez sur Non.

    Il est recommandé de laisser activée la case à cocher qui propose la mise à niveau de tous les sites Web de la solution.

    Si vous effectuez une mise à niveau vers .NET Framework 3.5, le fichier Web.config du projet est modifié en même temps que le fichier projet.

    Une fois la mise à niveau et la conversion terminées, un message indiquant que la première étape de conversion de votre projet est terminée s'affiche.

  7. Cliquez sur OK.

    L'Assistant affiche des informations sur l'état de la conversion.

  8. Cliquez sur Fermer.

Test du projet converti.

Une fois la conversion effectuée, vous pouvez tester le projet pour vous assurer qu'il s'exécute. Cela vous permettra également d'identifier le code dans le projet qui doit être mis à jour.

Pour vérifier que le projet s'exécute

  1. Si vous savez quelles sont les modifications requises pour que le code s'exécute avec la nouvelle version du .NET Framework, apportez ces modifications.

  2. Dans le menu Générer, cliquez sur Générer.

    Toute référence manquante ou autre problème de compilation au sein du projet s'affiche dans la fenêtre Liste d'erreurs. Les problèmes les plus probables sont des références d'assembly manquantes ou des problèmes liés aux types générés dynamiquement.

  3. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la page Web qui sera utilisée pour lancer l'application, puis cliquez sur Définir comme page de démarrage.

  4. Dans le menu Déboguer, cliquez sur Démarrer le débogage.

    Si le débogage n'est pas activé, la boîte de dialogue Débogage non activé s'affiche. Sélectionnez cette option pour ajouter un fichier Web.config dont le débogage est activé, puis cliquez sur OK.

  5. Vérifiez que le projet converti s'exécute comme prévu.

    Ne poursuivez pas le processus de conversion tant que toutes les erreurs de génération et d'exécution ne sont pas résolues.

Conversion de fichiers de code ASP.NET

Les fichiers de page Web ASP.NET et les fichiers de contrôles utilisateur Visual Studio 2008 qui utilisent le modèle code-behind sont associés à un fichier de concepteur. Les fichiers que vous venez de convertir seront associés à un fichier code-behind mais à aucun fichier de concepteur. Par conséquent, l'étape suivante consiste à générer des fichiers de concepteur.

Remarque :

Seuls les contrôles utilisateur et les pages Web ASP.NET dont le code apparaît dans un fichier de code séparé nécessitent un fichier de concepteur séparé. Aucun fichier concepteur n'est généré pour les pages qui disposent d'un code incorporé et ne sont associées à aucun fichier de code.

Pour convertir des fichiers de code ASP.NET

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet puis sur Convertir en application Web.

    Les fichiers sont convertis.

  2. Vérifiez que les fichiers de code convertis possèdent un fichier de code et un fichier de concepteur.

  3. Générez et exécutez le projet pour vérifier les résultats de la conversion.

Voir aussi

Concepts

Vue d'ensemble : conversion de sites Web et de projets Visual Studio en Visual Studio 2008

Vue d'ensemble des projets d'application Web

Autres ressources

Conversion à partir de Visual Studio .NET 2002 ou 2003