AspNetCompiler (attività)
L'attività AspNetCompiler
esegue il wrapping di aspnet_compiler.exe, un'utilità per precompilare ASP.NET applicazioni.
Parametri dell'attività
Nella tabella che segue vengono descritti i parametri dell'attività AspNetCompiler
.
Parametro | Descrizione |
---|---|
AllowPartiallyTrustedCallers |
Parametro Boolean facoltativo.Se questo parametro è true , l'assembly con nome sicuro consentirà chiamanti parzialmente attendibili. |
Clean |
Parametro Boolean facoltativoSe questo parametro è true , verrà eseguita una precompilazione pulita dell'applicazione. I componenti compilati in precedenza verranno ricompilati. Il valore predefinito è false . Questo campo corrisponde all'opzione -c in aspnet_compiler.exe. |
Debug |
Parametro Boolean facoltativo.Se questo parametro è true , durante la compilazione verranno restituite informazioni di debug (file con estensione pdb). Il valore predefinito è false . Questo campo corrisponde all'opzione -d in aspnet_compiler.exe. |
DelaySign |
Parametro Boolean facoltativo.Se questo parametro è true , al momento della creazione l'assembly verrà firmato solo parzialmente. |
FixedNames |
Parametro Boolean facoltativo.Se questo parametro è true , agli assembly compilati verranno assegnati nomi fissi. |
Force |
Parametro Boolean facoltativoSe questo parametro è true , l'attività sovrascriverà la directory di destinazione, se già esistente. Il contenuto esistente andrà perso. Il valore predefinito è false . Questo campo corrisponde all'opzione -f in aspnet_compiler.exe. |
KeyContainer |
Parametro String facoltativo.Specifica un contenitore di chiavi con nome sicuro. |
KeyFile |
Parametro String facoltativo.Specifica il percorso fisico del file di chiave con nome sicuro. |
MetabasePath |
Parametro String facoltativo.Specifica il percorso completo della metabase IIS dell'applicazione. Questo parametro non può essere combinato con il parametro VirtualPath o PhysicalPath . Questo campo corrisponde all'opzione -m in aspnet_compiler.exe. |
PhysicalPath |
Parametro String facoltativo.Specifica il percorso fisico dell'applicazione da compilare. Se questo parametro non è specificato, per individuare l'applicazione verrà usata la metabase di IIS. Questo campo corrisponde all'opzione -p in aspnet_compiler.exe. |
TargetFrameworkMoniker |
Parametro String facoltativo.Specifica l'elemento TargetFrameworkMoniker che indica la versione .NET Framework di aspnet_compiler.exe da usare. Vengono accettati solo moniker di .NET Framework. |
TargetPath |
Parametro String facoltativo.Specifica il percorso fisico in cui viene compilata l'applicazione. Se non è specificato, l'applicazione verrà precompilata sul posto. |
Updateable |
Parametro Boolean facoltativo.Se questo parametro è true , l'applicazione precompilata sarà aggiornabile. Il valore predefinito è false . Questo campo corrisponde all'opzione -u in aspnet_compiler.exe. |
VirtualPath |
Parametro String facoltativo.Percorso virtuale dell'applicazione da compilare. Se PhysicalPath è specificato, per individuare l'applicazione verrà usato il percorso fisico. In caso contrario verrà usata la metabase IIS, presupponendo che l'applicazione si trovi nel sito predefinito. Questo campo corrisponde all'opzione -v in aspnet_compiler.exe. |
Parametri ToolTaskExtension
Questa attività eredita dalla ToolTaskExtension classe , che eredita dalla ToolTask classe , che a sua volta eredita dalla Task classe . Questa catena di ereditarietà aggiunge diversi parametri alle attività che ne derivano.
Nella tabella seguente vengono descritti i parametri delle classi di base:
Parametro | Descrizione |
---|---|
EchoOff | Parametro bool facoltativo.Se impostata su true , questa attività passa /Q alla riga di comando di cmd.exe in modo che la riga di comando non venga copiata in stdout. |
EnvironmentVariables | Parametro di matrice String facoltativo.Matrice di definizioni di variabili di ambiente, separate da punti e virgola. Ogni definizione deve specificare un nome di variabile di ambiente e un valore separati da un segno di uguale. Queste variabili vengono passate all'eseguibile generato in aggiunta a o con override selettivo del blocco di ambiente standard. Ad esempio, Variable1=Value1;Variable2=Value2 . |
ExitCode | Parametro di sola lettura di output Int32 facoltativo.Specifica il codice di uscita fornito dal comando eseguito. Se l'attività ha registrato errori, ma il processo ha un codice di uscita pari a 0 (esito positivo), il parametro viene impostato su -1. |
LogStandardErrorAsError | Parametro bool facoltativo.Se true , tutti i messaggi ricevuti nel flusso di errori standard vengono registrati come errori. |
StandardErrorImportance | Parametro String facoltativo.Importanza con cui registrare il testo dal flusso di errore standard. |
StandardOutputImportance | Parametro String facoltativo.Importanza con cui registrare il testo dal flusso di output standard. |
Timeout | Parametro Int32 facoltativo.Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue , con cui si indica che non esiste alcun periodo di timeout. Il timeout è espresso in millisecondi. |
ToolExe | Parametro string facoltativo.I progetti possono implementarlo per eseguire l'override di un ToolName. Le attività possono eseguirne l'override per conservare il ToolName. |
ToolPath | Parametro string facoltativo.Specifica la posizione da cui l'attività carica il file eseguibile sottostante. Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild. |
UseCommandProcessor | Parametro bool facoltativo.Se true , questa attività crea un file batch per la riga di comando e lo esegue mediante il processore dei comandi anziché eseguire direttamente il comando. |
YieldDuringToolExecution | Parametro bool facoltativo.Se true , questa attività restituisce il nodo quando l'attività è in esecuzione. |
Esempio
Nell'esempio di codice seguente viene usata l'attività AspNetCompiler
per precompilare un'applicazione 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>