Freigeben über


AspNetCompiler-Aufgabe

Aktualisiert: November 2007

Die AspNetCompiler-Aufgabe schließt aspnet_compiler.exe ein, ein Dienstprogramm, mit dem ASP.NET-Anwendungen vorkompiliert werden können.

Aufgabenparameter

In der folgenden Tabelle werden die Parameter der AspNetCompiler-Aufgabe beschrieben.

Parameter

Beschreibung

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.

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.

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.

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.

Timeout

Optionaler Int32-Parameter.

Gibt die Zeit in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert lautet Int.MaxValue. Dieser gibt an, dass kein Timeoutintervall festgelegt ist.

ToolPath

Optionaler String-Parameter.

Gibt den Speicherort an, von dem die Aufgabe die zugrunde liegende ausführbare Datei (aspnet_compiler.exe) lädt. Wird dieser Parameter nicht angegeben, verwendet die Aufgabe den SDK-Installationspfad für die Framework-Version, in der MSBuild ausgeführt wird.

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.

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>

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben