Conversion de paramètres de projet Web

  • Article

Mise à jour : novembre 2007

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

<compilation>
  <assemblies>
    <add assembly="System.Messaging" />
  </assemblies>
</compilation>

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 :

    <compiler

    language="vb"

    compilerOptions="define:Trace" />

  • Constantes personnalisées (projets clients Visual Basic)

    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 :

    <compiler

    language="j#"

    compilerOptions="<list of options>" />

Voir aussi

Concepts

Conversion d'un projet Web de Visual Studio .NET

Conversion de solutions Web et de fichiers de projets