Procédure pas à pas : conversion d'un projet de site Web Visual Studio 2005 en projet d'application Web Visual Studio 2008

Mise à jour : novembre 2007

Cette procédure pas à pas décrit comment convertir un projet de site Web Visual Studio 2005 en un projet d'application Web Visual Studio 2008. Le modèle de projet d'application Web Visual Studio 2008 est identique au modèle de projet d'application Web Visual Studio 2005, une fonctionnalité intégrée à .NET Framework 2.0 SP1. Pour plus d'informations sur les projets d'application Web, consultez Vue d'ensemble des projets d'application Web.

Remarque :

Si le site Web est basé sur Microsoft ASP.NET AJAX, le processus de conversion nécessite des étapes supplémentaires hors du cadre de cette procédure pas à pas. Pour plus d'informations, consultez Comment : mettre à niveau un projet Web ASP.NET AJAX 1.0 vers .NET Framework 3.5.

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

  • Ouverture du site Web Visual Studio 2005 dans Visual Studio 2008.

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

  • Création d'un projet d'application Web Visual Studio 2008.

  • Copie des fichiers de site Web Visual Studio 2005 vers le nouveau projet d'application Web Visual Studio 2008.

  • Conversion de fichiers de code ASP.NET.

  • Test du projet converti.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer de la configuration suivante :

  • Visual Studio 2008.

  • Un site Web créé dans Visual Studio 2005 qui se compile et s'exécute sans erreur.

Conversion du site Web

Pour commencer, vous devez ouvrir le site Web dans Visual Studio 2008, qui lance la conversion.

Pour convertir le site Web

  1. Dans Visual Studio 2008, dans le menu Fichier, cliquez sur Ouvrir puis sur Site Web.

    La boîte de dialogue Ouvrir le site Web s'affiche.

  2. Recherchez le dossier qui contient les fichiers du site Web, puis cliquez sur Ouvrir.

    Visual Studio 2008 vous invite à mettre à niveau la version ciblée du .NET Framework pour le projet.

  3. Pour effectuer une mise à niveau vers .NET Framework 3.5, cliquez sur Oui.

    Remarque :

    Vous pouvez également modifier ultérieurement la version cible du .NET Framework manuellement, en utilisant les pages de propriétés du projet.

Test du site Web 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 site Web Visual Studio 2005 se compile et 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 le site Web.

  3. 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.

    La boîte de dialogue Le débogage de script est désactivé peut également s'afficher. Elle indique que le débogage de script est désactivé dans Internet Explorer. Pour activer le débogage du script client, suivez les instructions de la boîte de dialogue.

    Cliquez sur Oui pour poursuivre le débogage.

  4. Vérifiez que le projet 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.

  5. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sur Propriétés.

  6. Cliquez sur l'onglet Références.

  7. Notez les références requises dans le projet.

    Lorsque vous créez un projet dans la section suivante, vous devez vous assurer que toutes les références de ce projet apparaissent également dans le nouveau projet.

Création d'un projet d'application Web Visual Studio 2008

Vous pouvez maintenant créer un projet d'application Web Visual Studio 2008 vers lequel vous effectuerez une conversion.

Pour créer un projet d'application Web Visual Studio 2008

  1. Dans Visual Studio 2008, dans le menu Fichier, cliquez sur Nouveau puis sur Projet.

    Remarque :

    Vous créez un projet d'application Web en tant que projet Visual Studio, et non en tant que site Web.

    La boîte de dialogue Nouveau projet s'affiche.

  2. Sous Types de projets, sélectionnez Web.

  3. Sélectionnez le langage de programmation que vous souhaitez utiliser pour le projet.

  4. Sous Modèles, sélectionnez Application Web ASP.NET.

  5. Entrez un nom, un emplacement et un nom de solution pour le projet, puis sélectionnez Créer une nouvelle solution dans la liste Solution.

    Remarque :

    Créez le projet dans un dossier séparé à partir du site Web Visual Studio 2005 que vous convertissez. Cela simplifie le processus de conversion.

  6. Dans la liste des versions de .NET Framework, sélectionnez la version du .NET Framework que vous avez ciblée lors de la conversion initiale.

  7. Cliquez sur OK.

    Le site Web existant se ferme et le nouveau projet d'application Web est créé.

  8. Supprimez les fichiers Default.aspx et Web.config créés avec le nouveau projet.

  9. Dans Explorateur de solutions, développez Références et recherchez dans la liste des références par défaut les références requises dans le projet que vous convertissez.

  10. Si des références supplémentaires sont nécessaires, cliquez avec le bouton droit sur le nœud Références, puis sur Ajouter une référence pour créer les références requises dans la boîte de dialogue correspondante.

Copie de fichiers vers le projet d'application Web

Vous pouvez maintenant copier les fichiers projet de l'ancien projet vers le nouveau projet d'application Web.

Pour copier le fichier de l'ancien projet vers le nouveau projet d'application Web

  1. Dans l'Explorateur Windows, accédez au dossier qui contient les fichiers projet du site Web Visual Studio 2005.

  2. Sélectionnez les fichiers et les dossiers que vous souhaitez ajouter au nouveau projet puis copiez-les.

  3. Dans le nouveau projet de Visual Studio, dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet, puis sur Coller pour ajouter les fichiers copiés au nouveau projet.

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.

Test du projet d'application Web

Après avoir terminé de convertir des fichiers, vous pouvez tester le projet pour vérifier qu'il s'exécute correctement en tant que projet d'application Web.

Pour générer et exécuter le projet converti

  1. Dans le menu Générer, cliquez sur Générer pour compiler l'application.

    Toute référence manquante ou autre problème de compilation au sein de votre projet s'affiche dans la fenêtre Liste d'erreurs.

  2. Exécutez le projet.

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

Étapes suivantes

Si vous souhaitez convertir un projet du site Web Visual Studio 2005 qui contient des fonctionnalités AJAX en Visual Studio 2008, le processus global est semblable mais nécessite des étapes supplémentaires. Après avoir converti le projet Visual Studio, exécutez les étapes décrites dans Comment : mettre à niveau un projet Web ASP.NET AJAX 1.0 vers .NET Framework 3.5.

Vous pouvez convertir d'autres types de projets de versions antérieures de Visual Studio en Visual Studio 2008. Pour plus d'informations, consultez Vue d'ensemble : conversion de sites Web et de projets Visual Studio en Visual Studio 2008.

Voir aussi

Tâches

Comment : mettre à niveau un projet Web ASP.NET AJAX 1.0 vers .NET Framework 3.5

Concepts

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

Ciblage du .NET Framework pour des sites Web

Migration et conversion de sites Web ASP.NET