AspNetCompiler, tâche
Mise à jour : novembre 2007
La tâche AspNetCompiler encapsule aspnet_compiler.exe, un utilitaire servant à précompiler des applications ASP.NET.
Paramètres de la tâche
Le tableau suivant décrit les paramètres de la tâche AspNetCompiler.
Paramètre |
Description |
|---|---|
Clean |
Paramètre Boolean facultatif. Si ce paramètre a la valeur true, l'application précompilée générée est nettoyée. Tout composant précédemment compilé est recompilé. La valeur par défaut est false. Ce paramètre correspond au commutateur -c dans aspnet_compiler.exe. |
Debug |
Paramètre Boolean facultatif. Si ce paramètre a la valeur true, des informations de débogage (fichier .PDB) sont publiées pendant la compilation. La valeur par défaut est false. Ce paramètre correspond au commutateur -d dans aspnet_compiler.exe. |
Force |
Paramètre Boolean facultatif. Si ce paramètre a la valeur true, la tâche remplace le répertoire cible s'il existe déjà. Le contenu existant est perdu. La valeur par défaut est false. Ce paramètre correspond au commutateur -f dans aspnet_compiler.exe. |
MetabasePath |
Paramètre String facultatif. Spécifie le chemin d'accès complet à la métabase IIS de l'application. Ce paramètre ne peut pas être combiné avec les paramètres VirtualPath ou PhysicalPath. Ce paramètre correspond au commutateur -m dans aspnet_compiler.exe. |
PhysicalPath |
Paramètre String facultatif. Spécifie le chemin d'accès physique de l'application à compiler. Si ce paramètre est manquant, la métabase IIS est utilisée pour localiser l'application. Ce paramètre correspond au commutateur -p dans aspnet_compiler.exe. |
TargetPath |
Paramètre String facultatif. Spécifie le chemin d'accès physique à l'emplacement dans lequel l'application est compilée. S'il n'est pas spécifié, l'application est précompilée sur place. |
Timeout |
Paramètre Int32 facultatif. Spécifie la durée, en millisecondes, après laquelle la tâche exécutable est terminée. La valeur par défaut est Int.MaxValue, indiquant qu'il n'existe aucun délai d'attente. |
ToolPath |
Paramètre String facultatif. Spécifie l'emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent (aspnet_compiler.exe). Si ce paramètre n'est pas spécifié, la tâche utilise le chemin d'accès d'installation du Kit de développement logiciel qui correspond à la version de l'infrastructure exécutant MSBuild. |
Updateable |
Paramètre Boolean facultatif. Si ce paramètre a la valeur true, l'application précompilée peut être mise à jour. La valeur par défaut est false. Ce paramètre correspond au commutateur -u dans aspnet_compiler.exe. |
VirtualPath |
Paramètre String facultatif. Chemin d'accès virtuel de l'application à compiler. Si PhysicalPath est spécifié, le chemin d'accès physique est utilisé pour localiser l'application. Sinon, la métabase IIS est utilisée et l'application est supposée être hébergée dans le site par défaut. Ce paramètre correspond au commutateur -v dans aspnet_compiler.exe. |
Exemple
L'exemple de code suivant utilise la tâche AspNetCompiler pour précompiler une application ASP.NET.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<Target Name="PrecompileWeb">
<AspNetCompiler
VirtualPath="/MyWebSite"
PhysicalPath="c:\inetpub\wwwroot\MyWebSite\"
TargetPath="c:\precompiledweb\MyWebSite\"
Force="true"
Debug="true"
/>
</Target>
</Project>