AspNetCompiler (tâche)
La tâche AspNetCompiler enveloppe aspnet_compiler.exe, un utilitaire permettant de précompiler des applications ASP.NET.
Paramètres de tâche
Le tableau ci-dessous décrit les paramètres de la tâche AspNetCompiler .
| Paramètre | Description |
|---|---|
AllowPartiallyTrustedCallers |
Paramètre Boolean facultatif.Si ce paramètre a la valeur true, l’assembly à nom fort autorise les appelants partiellement fiables. |
Clean |
Paramètre Boolean facultatif.Si ce paramètre a la valeur true, l’application précompilée est générée après nettoyage. 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 émises pendant la compilation. La valeur par défaut est false. Ce paramètre correspond au commutateur -d dans aspnet_compiler.exe. |
DelaySign |
Paramètre Boolean facultatif.Si ce paramètre a la valeur true, l’assembly n’est pas complètement signé quand il est créé. |
FixedNames |
Paramètre Boolean facultatif.Si ce paramètre a la valeur true, des noms fixes sont attribués aux assemblys compilés. |
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. |
KeyContainer |
Paramètre String facultatif.Spécifie un conteneur de clé de nom fort. |
KeyFile |
Paramètre String facultatif.Spécifie le chemin physique au fichier de clé de nom fort. |
MetabasePath |
Paramètre String facultatif.Spécifie le chemin complet à la métabase IIS de l’application. Vous ne pouvez pas combiner ce paramètre 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 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. |
TargetFrameworkMoniker |
Paramètre String facultatif.Spécifie le TargetFrameworkMoniker indiquant la version .NET Framework d’aspnet_compiler.exe à utiliser. Accepte uniquement des monikers .NET Framework. |
TargetPath |
Paramètre String facultatif.Spécifie le chemin 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. |
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 virtuel de l’application à compiler. Si PhysicalPath est spécifié, le chemin physique est utilisé pour localiser l’application. Sinon, la métabase IIS est utilisée et l’application se trouve théoriquement dans le site par défaut. Ce paramètre correspond au commutateur -v dans aspnet_compiler.exe. |
Paramètres ToolTaskExtension
Cette tâche hérite de la classe ToolTaskExtension, laquelle hérite de la classe ToolTask, qui hérite elle-même de la classe Task. Cette chaîne d'héritage ajoute plusieurs paramètres aux tâches qui en dérivent.
Le tableau ci-dessous décrit les paramètres des classes de base :
| Paramètre | Description |
|---|---|
| EchoOff | Paramètre bool facultatif.Quand la valeur est true, cette tâche passe /Q à la ligne de commande cmd.exe de telle manière que cette dernière ne soit pas copiée dans stdout. |
| EnvironmentVariables | Paramètres de tableau String facultatif.Tableau de définitions de variables d’environnement, séparées par des points-virgules. Chaque définition devrait spécifier un nom et une valeur de variable d’environnement séparés par un signe égal. Ces variables sont transmises à l'exécutable généré en plus ou en remplacement sélectif du bloc environnement normal. Par exemple : Variable1=Value1;Variable2=Value2. |
| ExitCode | Paramètre en lecture seule de sortie Int32 facultatif.Spécifie le code de sortie fourni par la commande exécutée. Si la tâche a journalisé des erreurs, alors que le processus avait un code de sortie de 0 (réussite), ce paramètre prend la valeur -1. |
| LogStandardErrorAsError | Paramètre bool facultatif.Si la valeur est true, tous les messages reçus sur le flux d'erreur standard sont journalisés en tant qu'erreurs. |
| StandardErrorImportance | Paramètre String facultatif.Importance avec laquelle le texte doit être enregistré dans le flux d’erreur standard. |
| StandardOutputImportance | Paramètre String facultatif.Importance avec laquelle le texte doit être enregistré dans le flux de sortie standard. |
| Timeout | Paramètre Int32 facultatif.Spécifie le délai, en millisecondes, après lequel l’exécutable de la tâche est arrêté. La valeur par défaut est Int.MaxValue, ce qui indique qu’il n’existe aucun délai d’expiration. Délai d’expiration en millisecondes. |
| ToolExe | Paramètre string facultatif.Les projets peuvent l'implémenter pour remplacer un ToolName. Les tâches peuvent le remplacer pour préserver le ToolName. |
| ToolPath | Paramètre string facultatif.Spécifie l’emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent. Si ce paramètre n'est pas spécifié, la tâche utilise le chemin d'installation du SDK qui correspond à la version de l'infrastructure qui exécute MSBuild. |
| UseCommandProcessor | Paramètre bool facultatif.Quand la valeur est true, cette tâche crée un fichier de commandes pour la ligne de commande et l'exécute à l'aide de l'interpréteur de commandes au lieu d'exécuter la commande directement. |
| YieldDuringToolExecution | Paramètre bool facultatif.Quand la valeur est true, cette tâche donne le nœud quand sa tâche s'exécute. |
Exemple
L’exemple de code suivant utilise la tâche AspNetCompiler pour précompiler une application ASP.NET.
<Project xmlns="http://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>