Étant donné que Visual Studio ne conserve pas les fichiers projet pour le développement Web, le processus de conversion doit transférer les paramètres projet et de solution pertinents dans un format Visual Studio. Par exemple, le processus de conversion déplace des paramètres projet dans le fichier Web.config, qui, dans Microsoft Visual Studio 2005, est développé afin de stocker plus d'informations que dans les versions antérieures de Visual Studio .NET.
De nombreux paramètres conservés dans Visual Studio .NET ne sont pas applicables à Visual Studio 2005 ; ils ne sont donc pas convertis. Par exemple, les paramètres projet pour le mode d'accès au Web (partage de fichiers ou FrontPage) et pour les valeurs par défaut du concepteur ne s'appliquent pas dans Visual Studio ; ils ne sont donc pas convertis. Les paramètres projet qui ont pour valeur des valeurs par défaut ne sont pas non plus convertis ; c'est-à-dire que Visual Studio ne crée pas de nouveau paramètre avec la valeur par défaut.
Projets avec plusieurs configurations
Si un projet contient plusieurs configurations (compilation de débogage, compilation de version finale, etc.), la conversion suit cette logique :
Si le projet contient uniquement les configurations Debug et Release, alors la configuration Debug est convertie en Visual Studio 2005.
Si les configurations supplémentaires existent, Visual Studio vous invite à modifier les paramètres de configuration qui doivent être convertis en Visual Studio 2005.
Références
Les références aux assemblys dans le dossier Bin du projet ne doivent pas être convertis ; les sites Web Visual Studio sélectionnent automatiquement des références au code dans le dossier Bin. Si le projet contient une référence à un assembly dans le Global Assembly Cache, la référence est déplacée dans le fichier Web.config au format suivant.
Les références d'assembly ne sont pas converties si l'assembly est déjà référencé par défaut dans ASP.NET (par exemple, System.Drawing).
Dans Visual Studio .NET, la propriété CopyLocal des assemblys référencés (par exemple, les assemblys qui sont référencés en dehors de la solution dans laquelle le projet Web est localisé) pourrait avoir la valeur true, ce qui mettrait automatiquement à jour l'assembly référencé. Dans Visual Studio 2005, ce comportement est remplacé par la création d'un fichier d'actualisation dans le dossier Bin. Le fichier d'actualisation contient le chemin d'accès à l'assembly référencé externe et porte un nom composé du nom de l'assembly et de l'extension .refresh.
Les références Web XML sont converties en copiant le fichier .wsdl dans le répertoire App_WebReferences. Le proxy de service Web et les fichiers de mappage de référence ne sont pas requis dans Visual Studio 2005.
Conversion de paramètres courants
Le tableau suivant répertorie des paramètres du projet Propriétés communes et leur traitement par le processus de conversion Visual Studio.
Remarque :
Vous pouvez consulter les valeurs actuelles de ces paramètres dans Visual Studio. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, cliquez sur Propriétés puis sur Propriétés communes.
Paramètre
Logique de conversion
Général
Les paramètres ne sont pas convertis.
Paramètres Web
Les paramètres ne sont pas convertis.
Paramètres par défaut du concepteur
Les paramètres ne sont pas convertis.
Chemin aux références
Les paramètres ne sont pas convertis.
Générer (projets clients Visual Basic)
Option Explicit
Si sa valeur est false, ce paramètre est déplacé dans le fichier Web.config :
<compilation explicit="false">
Option Strict
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compilation strict="true" />
Option Compare
Si sa valeur est Text, ce paramètre est déplacé dans le fichier Web.config :
<compiler language="vb"
compilerOptions="optioncompare:text" />
Importations (projets clients Visual Basic)
Les paramètres d'importation qui ne sont pas déjà importés par défaut dans ASP.NET sont déplacés dans le fichier Web.config :
<pages>
<namespaces>
<add namespace="Namespace" />
</namespaces>
</pages>
La conversion affecte uniquement les paramètres d'importation pour les pages Web ASP.NET. Pour les classes dans le répertoire App_Code, vous devez ajouter manuellement des paramètres d'importation.
Conversion de paramètres de configuration
Les paramètres de configuration pour un projet diffèrent légèrement selon le langage de programmation que le projet utilise. Les tableaux suivants répertorient le traitement des paramètres de configuration par le processus de conversion Visual Studio en fonction du langage.
Remarque :
Vous pouvez consulter les valeurs actuelles de ces paramètres dans Visual Studio. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, cliquez sur Propriétés puis sur Propriétés de configuration.
Paramètres de configuration : tous les langages
Le tableau suivant répertorie les paramètres du projet Configuration qui apparaissent dans tous les types de projets et il décrit leur traitement par le processus de conversion Visual Studio.
Paramètre
Logique de conversion
Débogage
Activer le débogage ASP
Le paramètre n'est pas converti.
Activer le débogage ASP.NET
Le paramètre n'est pas converti.
Activer le débogage non managé
Le paramètre est converti tel quel.
Activer le débogage SQL Server
Le paramètre est converti tel quel.
Paramètres Action de démarrage
Les paramètres sont déplacés dans un cache côté client par utilisateur.
Arguments de la ligne de commande
Le paramètre est converti tel quel.
Répertoire de travail
Le paramètre est converti tel quel.
Toujours utiliser Internet Explorer
Le paramètre n'est pas converti.
Activer le débogage distant
Le paramètre n'est pas converti.
Ordinateur de débogage distant
Le paramètre n'est pas converti.
Paramètres de configuration : Visual Basic .NET
Le tableau suivant répertorie les paramètres du projet Configuration qui apparaissent dans un projet Visual Basic .NET et il décrit leur traitement par le processus de conversion Visual Studio.
Paramètre
Logique de conversion
Générer
Chemin de sortie
Le paramètre n'est pas converti.
Générer des informations de débogage
Le paramètre est déplacé vers le fichier Web.config :
<compilation debug="true|false" />
Inscrire pour COM Interop
Le paramètre n'est pas converti.
Activer les avertissements de génération (projets clients Visual Basic)
Le paramètre n'est pas converti. Les avertissements de génération sont toujours activés dans Visual Studio .NET.
Considérer les avertissements du compilateur comme des erreurs (projets clients Visual Basic)
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="vb"
compilerOptions="warnaserror+" />
Définir la constante DEBUG (projets clients Visual Basic)
Le paramètre est déplacé vers le fichier Web.config :
<compiler
language="vb"
compilerOptions="define:Debug" />
Définir la constante TRACE (projets clients Visual Basic)
Le paramètre est déplacé vers le fichier Web.config :
Le paramètre est déplacé vers le fichier Web.config :
<compiler
language="vb"
compilerOptions="define:<list>" />
Documentation XML
S'il est défini, ce paramètre est déplacé dans le fichier Web.config :
<compiler language="c#"
compilerOptions="doc:<filepath>" />
Constantes de compilation conditionnelle
Le paramètre est déplacé vers le fichier Web.config :
<compiler
language="c#"
compilerOptions="d:<symbols>" />
Optimiser le code
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="o" />
Vérifier les dépassements de capacité arithmétiques positifs et négatifs
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="checked+" />
Autoriser les blocs de code unsafe
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="unsafe+" />
Niveau d'avertissement
Si sa valeur est différente de 4, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="w:<level>" />
Considérer les avertissements comme des erreurs
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler language="c#"
compilerOptions="warnaserror+" />
Supprimer les avertissements spécifiques
S'il est défini, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="nowarn:<warning list>" />
Optimisations (projets clients Visual Basic)
Supprimer les contrôles de dépassement sur les entiers
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="vb"
compilerOptions="removeintchecks+" />
Permet les optimisations
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="vb"
compilerOptions="optimize+" />
Activer la génération incrémentielle
Le paramètre n'est pas converti.
Adresse de base DLL
Le paramètre n'est pas converti.
Paramètres de configuration : C#
Le tableau suivant répertorie les paramètres du projet Configuration qui apparaissent dans un projet C# et il décrit leur traitement par le processus de conversion Visual Studio.
Paramètre
Logique de conversion
Générer
Constantes de compilation conditionnelle
Le paramètre est déplacé vers le fichier Web.config :
<compiler
language="c#"
compilerOptions="d:<symbols>" />
Optimiser le code
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="o" />
Vérifier les dépassements de capacité arithmétiques positifs et négatifs
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="checked+" />
Autoriser les blocs de code unsafe
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="unsafe+" />
Niveau d'avertissement
Si sa valeur est différente de 4, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="w:<level>" />
Considérer les avertissements comme des erreurs
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler language="c#"
compilerOptions="warnaserror+" />
Supprimer les avertissements spécifiques
S'il est défini, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="nowarn:<warning list>" />
Chemin de sortie
Le paramètre n'est pas converti.
Documentation XML
S'il est défini, ce paramètre est déplacé dans le fichier Web.config :
<compiler language="c#"
compilerOptions="doc:<filepath>" />
Générer des informations de débogage
Le paramètre est déplacé vers le fichier Web.config :
<compilation debug="true|false" />
Inscrire pour COM Interop
Le paramètre n'est pas converti.
Avancé
Génération incrémentielle
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="incr+" />
Adresse de base
Le paramètre n'est pas converti.
Alignement des fichiers
Si sa valeur est différente de 4096, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="filealign:<n>" />
Ne pas utiliser Mscorlib
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="c#"
compilerOptions="nostdlib+" />
Paramètres de configuration : J#
Le tableau suivant répertorie les paramètres du projet Configuration qui apparaissent dans un projet Microsoft J# .NET et il décrit leur traitement par le processus de conversion Visual Studio.
Paramètre
Logique de conversion
Générer
Constantes de compilation conditionnelle
Le paramètre est déplacé vers le fichier Web.config :
<compiler
language="j#"
compilerOptions="d:<symbols>" />
Optimiser le code
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="j#"
compilerOptions="o" />
Niveau d'avertissement
Si sa valeur est différente de 4, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="j#"
compilerOptions="w:<level>" />
Considérer les avertissements comme des erreurs
Si sa valeur est true, ce paramètre est déplacé dans le fichier Web.config :
<compiler language="j#"
compilerOptions="warnaserror+" />
Supprimer les avertissements spécifiques
S'il est défini, ce paramètre est déplacé dans le fichier Web.config :
<compiler
language="j#"
compilerOptions="nowarn:<warning list>" />
Chemin de sortie
Le paramètre n'est pas converti.
Générer des informations de débogage
Le paramètre est déplacé vers le fichier Web.config :
<compilation debug="true|false" />
Inscrire pour COM Interop
Le paramètre n'est pas converti.
Avancé
Adresse de base
Le paramètre n'est pas converti.
Options supplémentaires
S'il est défini, ce paramètre est déplacé dans le fichier Web.config :