AspNetCompiler-Aufgabe

  • Artikel

Die Aufgabe AspNetCompiler schließt aspnet_compiler.exe ein, ein Hilfsprogramm zum Vorkompilieren von ASP.NET-Anwendungen.

Aufgabenparameter

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

Parameter Beschreibung
AllowPartiallyTrustedCallers Optionaler Boolean-Parameter.

Wenn dieser Parameter true ist, erlaubt die Assembly mit starkem Namen Aufrufer, die nicht voll vertrauenswürdig sind.
Clean Optionaler Boolean-Parameter

Wenn dieser Parameter true ist, wird die vorkompilierte Anwendung bereinigt erstellt. Zuvor kompilierte Komponenten werden erneut kompiliert. Der Standardwert ist false. Dieser Parameter entspricht dem -c-Schalter in aspnet_compiler.exe.
Debug Optionaler Boolean-Parameter.

Wenn dieser Parameter true ist, werden während der Kompilierung Debuginformationen (PDB-Datei) ausgegeben. Der Standardwert ist false. Dieser Parameter entspricht dem -d-Schalter in aspnet_compiler.exe.
DelaySign Optionaler Boolean-Parameter.

Wenn dieser Parameter true ist, wird die Assembly bei ihrer Erstellung nicht vollständig signiert.
FixedNames Optionaler Boolean-Parameter.

Wenn dieser Parameter true ist, erhalten die kompilierten Assemblys feste Namen.
Force Optionaler Boolean-Parameter

Wenn dieser Parameter true ist, überschreibt die Aufgabe das Zielverzeichnis, wenn es bereits vorhanden ist. Vorhandene Inhalte gehen verloren. Der Standardwert ist false. Dieser Parameter entspricht dem -f-Schalter in aspnet_compiler.exe.
KeyContainer Optionaler String-Parameter.

Gibt einen Schlüsselcontainer mit starkem Namen an.
KeyFile Optionaler String-Parameter.

Legt den physischen Pfad zur Schlüsseldatei mit starkem Namen fest.
MetabasePath Optionaler String-Parameter.

Legt den vollständigen IIS-Metabasispfad der Anwendung fest. Dieser Parameter kann nicht mit Parameter VirtualPath oder PhysicalPath kombiniert werden. Dieser Parameter entspricht dem -m-Schalter in aspnet_compiler.exe.
PhysicalPath Optionaler String-Parameter.

Legt den physischen Pfad der zu kompilierenden Anwendung fest. Wenn dieser Parameter nicht vorhanden ist, wird die IIS-Metabasis verwendet, um die Anwendung zu suchen. Dieser Parameter entspricht dem -p-Schalter in aspnet_compiler.exe.
TargetFrameworkMoniker Optionaler String-Parameter.

Legt den TargetFrameworkMoniker fest, der angibt, welche .NET Framework-Version von aspnet_compiler.exe verwendet werden soll. Akzeptiert nur .NET Framework-Moniker.
TargetPath Optionaler String-Parameter.

Legt den physischen Pfad fest, unter dem die Anwendung kompiliert wird. Wenn nicht angegeben, wird die Anwendung direkt vorkompiliert.
Updateable Optionaler Boolean-Parameter.

Wenn dieser Parameter true ist, ist die vorkompilierte Anwendung aktualisierbar. Der Standardwert ist false. Dieser Parameter entspricht dem -u-Schalter in aspnet_compiler.exe.
VirtualPath Optionaler String-Parameter.

Der virtuelle Pfad der zu kompilierenden Anwendung. Wenn PhysicalPath festgelegt ist, wird der physische Pfad verwendet, um die Anwendung zu suchen. Andernfalls wird die IIS-Metabasis verwendet, und es wird angenommen, dass sich die Anwendung am Standardspeicherort befindet. Dieser Parameter entspricht dem -v-Schalter in aspnet_compiler.exe.

ToolTaskExtension-Parameter

Dieser Task erbt aus der ToolTaskExtension-Klasse, die aus der ToolTask-Klasse erbt, welche wiederum aus der Task-Klasse erbt. Diese Vererbungskette fügt verschiedene Parameter zu den Aufgaben hinzu, die aus ihnen abgeleitet werden.

In der folgenden Tabelle werden die Parameter der Basisklassen beschrieben:

Parameter Beschreibung
EchoOff Optionaler bool-Parameter.

Bei der Festlegung auf true gibt diese Aufgabe /Q an die Befehlszeile cmd.exe so weiter, dass die Befehlszeile nicht zu „stdout“ kopiert wird.
EnvironmentVariables Optionaler String-Arrayparameter.

Array aus Umgebungsvariablendefinitionen, getrennt durch Semikolons. Jede Definition sollte einen Namen und einen Wert für eine Umgebungsvariable angeben, getrennt durch ein Gleichheitszeichen. Diese Variablen werden an die erstellte ausführbare Datei zusätzlich zum regulären Umgebungsblock oder zum ausgewählten Überschreiben hinzugefügt. Beispiel: Variable1=Value1;Variable2=Value2.
ExitCode Optionaler schreibgeschützter Int32-Ausgabeparameter.

Gibt den durch den ausgeführten Befehl bereitgestellten Exitcode an. Wenn bei der Aufgabe Fehler protokolliert wurden, der Prozess jedoch über einen Exitcode von „0“ (Erfolg) verfügt hat, wird dies auf „-1“ festgelegt.
LogStandardErrorAsError Optionaler bool-Parameter.

Wenn true gegeben ist, werden alle im Standardfehlerstream empfangenen Meldungen als Fehler protokolliert.
StandardErrorImportance Optionaler String-Parameter.

Wichtigkeit, mit der Text aus dem Standardfehlerstream protokolliert wird.
StandardOutputImportance Optionaler String-Parameter.

Wichtigkeit, mit der Text aus dem Standardausgabestream protokolliert wird.
Timeout Optionaler Int32-Parameter.

Gibt die Zeitdauer in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert ist Int.MaxValue. Dieser gibt an, dass es kein Zeitlimit gibt. Das Timeout in Millisekunden.
ToolExe Optionaler string-Parameter.

Projekte implementieren dies möglicherweise zum Überschreiben eines ToolName. Aufgaben überschreiben dies möglicherweise zum Beibehalten des ToolName.
ToolPath Optionaler string-Parameter.

Gibt den Speicherort an, von wo aus die Aufgabe die zugrunde liegende ausführbare Datei lädt. Wenn dieser Parameter nicht angegeben ist, verwendet die Aufgabe den SDK-Installationspfad der Version des Frameworks, die von MSBuild ausgeführt wird.
UseCommandProcessor Optionaler bool-Parameter.

Wenn die Festlegung auf true gegeben ist, erstellt diese Aufgabe eine Batchdatei für die Befehlszeile und führt sie aus, indem der Befehl nicht direkt ausgeführt wird, sondern der Befehlsprozessor verwendet wird.
YieldDuringToolExecution Optionaler bool-Parameter.

Bei der Festlegung auf true ergibt diese Aufgabe den Knoten, wenn dessen Aufgabe ausgeführt wird.

Beispiel

Im folgenden Codebeispiel wird die AspNetCompiler-Aufgabe zum Vorkompilieren einer ASP.NET-Anwendung verwendet.

<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>

Siehe auch