AspNetCompiler-Aufgabe
Die AspNetCompiler-Aufgabe umschließt aspnet_compiler.exe, ein Hilfsprogramm, mit dem ASP.NET-Anwendungen vorkompiliert werden können.
Aufgabenparameter
In der folgenden Tabelle werden die Parameter der AspNetCompiler-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
AllowPartiallyTrustedCallers |
Optionaler Boolean-Parameter. Wenn dieser Parameter ist true, wird die Assembly mit starkem Namen teilweise vertrauenswürdige Aufrufer zulassen. |
Clean |
Optionaler Boolean-Parameter. Wenn dieser Parameter den Wert true aufweist, wird die vorkompilierte Anwendung sauber erstellt. Möglicherweise zuvor kompilierte Komponenten werden erneut kompiliert. Der Standardwert ist false. Dieser Parameter entspricht dem -c-Schalter von aspnet_compiler.exe. |
Debug |
Optionaler Boolean-Parameter. Wenn dieser Parameter den Wert true aufweist, werden während der Kompilierung Debuginformationen (PDB-Datei) ausgegeben. Der Standardwert ist false. Dieser Parameter entspricht dem -d-Schalter von aspnet_compiler.exe. |
DelaySign |
Optionaler Boolean-Parameter. Ist dieser Parameter true, wird die Assembly beim Erstellen nicht vollständig signiert. |
FixedNames |
Optionaler Boolean-Parameter. Wenn dieser Parameter ist true, werden den kompilierten Assemblys feste Namen gegeben.. |
Force |
Optionaler Boolean-Parameter. Wenn dieser Parameter den Wert true aufweist, überschreibt die Aufgabe das Zielverzeichnis, sofern dieses bereits vorhanden ist. Bestehender Inhalt geht verloren. Der Standardwert ist false. Dieser Parameter entspricht dem -f-Schalter von aspnet_compiler.exe. |
KeyContainer |
Optionaler String-Parameter. Gibt einen starken Namenschlüsselcontainer an. |
KeyFile |
Optionaler String-Parameter. Gibt den physischen Pfad zur Schlüsseldatei mit starkem Namen... |
MetabasePath |
Optionaler String-Parameter. Gibt den vollständigen IIS-Metabasispfad der Anwendung an. Dieser Parameter kann nicht mit dem VirtualPath-Parameter oder dem PhysicalPath-Parameter kombiniert werden. Dieser Parameter entspricht dem -m-Schalter von aspnet_compiler.exe. |
PhysicalPath |
Optionaler String-Parameter. Gibt den physikalischen Pfad der Anwendung an, die kompiliert werden soll. Wenn dieser Parameter nicht angegeben ist, wird anhand der IIS-Metabasis nach der Anwendung gesucht. Dieser Parameter entspricht dem -p-Schalter von aspnet_compiler.exe. |
TargetFrameworkMoniker |
Optionaler String-Parameter. Gibt den TargetFrameworkMoniker an, der angibt, welche .NET Framework-Version von aspnet_compiler.exe verwendet werden soll. Akzeptiert nur .NET Framework-Moniker. |
TargetPath |
Optionaler String-Parameter. Gibt den physikalischen Pfad an, in dem die Anwendung kompiliert wird. Ist der Pfad nicht angegeben, wird die Anwendung direkt vorkompiliert. |
Updateable |
Optionaler Boolean-Parameter. Wenn dieser Parameter den Wert true aufweist, ist die vorkompilierte Anwendung aktualisierbar. Der Standardwert ist false. Dieser Parameter entspricht dem -u-Schalter von aspnet_compiler.exe. |
VirtualPath |
Optionaler String-Parameter. Der virtuelle Pfad der zu kompilierenden Anwendung. Wenn PhysicalPath angegeben ist, wird anhand des physikalischen Pfads nach der Anwendung gesucht. Andernfalls wird die IIS-Metabasis verwendet und angenommen, dass sich die Anwendung im Standardverzeichnis befindet. Dieser Parameter entspricht dem -v-Schalter von aspnet_compiler.exe. |
Hinweise
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der ToolTaskExtension-Klasse, die selbst von der ToolTask-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter ToolTaskExtension-Basisklasse.
Beispiel
Im folgenden Codebeispiel wird die AspNetCompiler-Aufgabe verwendet, um eine ASP.NET-Anwendung vorzukompilieren.
<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>