Comment : générer des noms fixes avec l'outil de compilation ASP.NET

  • Article

Mise à jour : novembre 2007

L'outil de compilation ASP.NET (Aspnet_compiler.exe) utilise des noms d'assemblys qui sont générés à la compilation et sont régénérés à chaque compilation suivante. Ces noms d'assemblys générés fonctionnent bien avec les sites Web qui sont déployés en entier, mais ils ne conviennent pas aux sites Web qui doivent libérer des mises à jour à des parties spécifiques du site Web sans redéployer le site Web entier.

Vous pouvez utiliser le commutateur -fixednames pour que l'outil de compilation ASP.NET génère des noms d'assemblys fixe. Lorsque vous utilisez le commutateur -fixednames, l'outil de compilation ASP.NET procède comme suit :

  • Créez un assembly pour chaque page .aspx dans l'application. Vous devez limiter le nombre de pages dans votre application pour réduire le nombre des assemblys générés.

  • Utilisez le chemin d'accès virtuel de la page comme nom de l'assembly de la page. Si la longueur du chemin d'accès virtuel dépasse la longueur limite des noms de fichiers du système d'exploitation, l'outil utilise à la place un hachage du chemin d'accès virtuel.

  • Compilez les fichiers dans les répertoires de niveau supérieur, tels que le répertoire App_Code, dans un seul assembly (comme la compilation par défaut).

La procédure de cette rubrique utilise les commutateurs et les paramètres d'Aspnet_compiler.exe. Pour plus d'informations sur cet outil, consultez ASP.NET Compilation Tool, outil (Aspnet_compiler.exe).

Pour plus d'informations sur la précompilation, consultez Précompilation du site Web ASP.NET.

Pour compiler un site Web avec des noms d'assemblys fixes

  1. Ouvrez une fenêtre de commande et accédez au dossier qui contient le .NET Framework.

    Le .NET Framework est installé à l'emplacement suivant.

    %windir%\Microsoft.NET\Framework\version

  2. Exécutez la commande aspnet_compiler en tapant ce qui suit à une invite de commandes.

    aspnet_compiler -v virtualPathtargetPath -fixednames

    Le paramètre virtualPath indique le chemin d'accès virtuel des services IIS (Internet Information Services) de votre site Web. Le paramètre targetPath constitue un chemin d'accès physique au répertoire de destination.

    Si votre site Web n'est pas une application IIS et par conséquent n'a aucune entrée dans la métabase IIS, tapez la commande suivante dans une invite de commandes.

    aspnet_compiler -p physicalOrRelativePath -v / targetPath -fixedNames

    Dans ce cas, le paramètre physicalOrRelativePath fait référence au chemin qualifié complet du répertoire où se trouvent les fichiers du site Web ou à un chemin d'accès relatif au répertoire actif. L'opérateur point (.) est autorisé dans le paramètre physicalOrRelativePath. Le commutateur -v spécifie une racine dont le compilateur se servira pour résoudre les références de la racine de l'application, par exemple avec l'opérateur tilde (~). Lorsque vous spécifiez la valeur / pour le commutateur -v, le compilateur résout les chemins d'accès en utilisant le chemin d'accès physique comme racine.

    Le paramètre targetPath constitue un chemin d'accès physique au répertoire de destination.

Voir aussi

Tâches

Comment : précompiler des sites Web ASP.NET à des fins de développement

Autres ressources

Précompilation du site Web ASP.NET