AspNetCompiler — zadanie

  • Artykuł

Zadanie AspNetCompiler opakowuje aspnet_compiler.exe, narzędzie do prekompilowania aplikacji ASP.NET.

Parametry zadania

W poniższej tabeli opisano parametry AspNetCompiler zadania.

Parametr opis
AllowPartiallyTrustedCallers Opcjonalny Boolean parametr.

Jeśli ten parametr ma truewartość , zestaw o silnej nazwie będzie zezwalał na częściowo zaufane wywołania.
Clean Opcjonalny Boolean parametr

Jeśli ten parametr ma truewartość , wstępnie skompilowana aplikacja zostanie skompilowana. Wszystkie wcześniej skompilowane składniki zostaną ponownie skompilowane. Wartość domyślna to false. Ten parametr odpowiada przełącznikowi -c na aspnet_compiler.exe.
Debug Opcjonalny Boolean parametr.

Jeśli ten parametr to true, informacje o debugowaniu (. Plik PDB) jest emitowany podczas kompilacji. Wartość domyślna to false. Ten parametr odpowiada przełącznikowi -d na aspnet_compiler.exe.
DelaySign Opcjonalny Boolean parametr.

Jeśli ten parametr to true, zestaw nie jest w pełni podpisany podczas tworzenia.
FixedNames Opcjonalny Boolean parametr.

Jeśli ten parametr to true, skompilowane zestawy będą mieć stałe nazwy.
Force Opcjonalny Boolean parametr

Jeśli ten parametr ma truewartość , zadanie zastąpi katalog docelowy, jeśli już istnieje. Istniejąca zawartość jest utracona. Wartość domyślna to false. Ten parametr odpowiada przełącznikowi -f na aspnet_compiler.exe.
KeyContainer Opcjonalny String parametr.

Określa kontener klucza silnej nazwy.
KeyFile Opcjonalny String parametr.

Określa ścieżkę fizyczną do pliku klucza silnej nazwy.
MetabasePath Opcjonalny String parametr.

Określa pełną ścieżkę metabazy usług IIS aplikacji. Nie można połączyć tego parametru z parametrami VirtualPath lub PhysicalPath . Ten parametr odpowiada przełącznikowi -m w pliku aspnet_compiler.exe.
PhysicalPath Opcjonalny String parametr.

Określa ścieżkę fizyczną aplikacji do skompilowania. Jeśli brakuje tego parametru, metabaza usług IIS jest używana do lokalizowania aplikacji. Ten parametr odpowiada przełącznikowi -p na aspnet_compiler.exe.
TargetFrameworkMoniker Opcjonalny String parametr.

Określa element TargetFrameworkMoniker wskazujący, która wersja programu .NET Framework aspnet_compiler.exe powinna być używana. Akceptuje tylko monikers programu .NET Framework.
TargetPath Opcjonalny String parametr.

Określa ścieżkę fizyczną, do której jest kompilowana aplikacja. Jeśli nie zostanie określony, aplikacja jest wstępnie skompilowana w miejscu.
Updateable Opcjonalny Boolean parametr.

Jeśli ten parametr to true, wstępnie skompilowana aplikacja będzie aktualizowalna. Wartość domyślna to false. Ten parametr odpowiada przełącznikowi -u na aspnet_compiler.exe.
VirtualPath Opcjonalny String parametr.

Ścieżka wirtualna aplikacji do skompilowania. Jeśli PhysicalPath zostanie określona, ścieżka fizyczna jest używana do lokalizowania aplikacji. W przeciwnym razie jest używana metabaza usług IIS i zakłada się, że aplikacja znajduje się w lokacji domyślnej. Ten parametr odpowiada przełącznikowi -v na aspnet_compiler.exe.

Parametry toolTaskExtension

To zadanie dziedziczy z ToolTaskExtension klasy dziedziczonej ToolTask po klasie, która dziedziczy się po Task klasie. Ten łańcuch dziedziczenia dodaje kilka parametrów do zadań, które pochodzą z nich.

W poniższej tabeli opisano parametry klas bazowych:

Parametr opis
EchoOff Opcjonalny bool parametr.

Gdy jest ustawiona wartość true, to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do pliku stdout.
EnvironmentVariables Opcjonalny String parametr tablicy.

Tablica definicji zmiennych środowiskowych oddzielona średnikami. Każda definicja powinna określać nazwę zmiennej środowiskowej i wartość oddzieloną znakiem równości. Te zmienne są przekazywane do zduplikowanego pliku wykonywalnego oprócz zwykłego bloku środowiska lub selektywnego zastępowania. Na przykład Variable1=Value1;Variable2=Value2.
ExitCode Opcjonalny Int32 parametr tylko do odczytu.

Określa kod zakończenia udostępniany przez wykonane polecenie. Jeśli zadanie zarejestrowało błędy, ale proces miał kod zakończenia 0 (powodzenie), jest to ustawione na -1.
LogStandardErrorAsError Opcjonalny bool parametr.

Jeśli trueprogram , wszystkie komunikaty odebrane w standardowym strumieniu błędów są rejestrowane jako błędy.
StandardErrorImportance Opcjonalny String parametr.

Ważność rejestrowania tekstu ze standardowego strumienia błędów.
StandardOutputImportance Opcjonalny String parametr.

Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego.
Timeout Opcjonalny Int32 parametr.

Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu. Limit czasu wynosi w milisekundach.
ToolExe Opcjonalny string parametr.

Projekty mogą implementować tę funkcję, aby zastąpić element ToolName. Zadania mogą zastąpić tę wartość, aby zachować wartość ToolName.
ToolPath Opcjonalny string parametr.

Określa lokalizację, z której zadanie ładuje źródłowy plik wykonywalny. Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild.
UseCommandProcessor Opcjonalny bool parametr.

Po ustawieniu truewartości to zadanie tworzy plik wsadowy dla wiersza polecenia i wykonuje go przy użyciu procesora poleceń zamiast bezpośredniego wykonywania polecenia.
YieldDuringToolExecution Opcjonalny bool parametr.

Gdy jest ustawiona wartość true, to zadanie daje węzeł, gdy jego zadanie jest wykonywane.

Przykład

Poniższy przykład kodu używa AspNetCompiler zadania do wstępnego kompilowania aplikacji 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>

Zobacz też