AspNetCompiler - задача

  • Статья

Задача AspNetCompiler создает оболочку для программы aspnet_compiler.exe, которая выполняет предварительную компиляцию приложений ASP.NET.

Параметры задачи

В следующей таблице приводятся параметры задачи AspNetCompiler.

Параметр Описание
AllowPartiallyTrustedCallers Необязательный параметр Boolean.

Если этот параметр имеет значение true, сборка со строгим именем допускает вызовы с частичным доверием.
Clean Необязательный параметр Boolean.

Если этот параметр имеет значение true, то для предварительно скомпилированного приложения будет выполнена чистая сборка. Все ранее скомпилированные компоненты будут перекомпилированы. Значение по умолчанию — false. Этот параметр соответствует параметру командной строки -c для aspnet_compiler.exe.
Debug Необязательный параметр Boolean.

Если этот параметр имеет значение true, то во время компиляции создается отладочная информация (PDB-файл). Значение по умолчанию — false. Этот параметр соответствует параметру командной строки -d для aspnet_compiler.exe.
DelaySign Необязательный параметр Boolean.

Если этот параметр имеет значение true, сборка не подписывается полностью при создании.
FixedNames Необязательный параметр Boolean.

Если этот параметр имеет значение true, скомпилированным сборкам будут присвоены фиксированные имена.
Force Необязательный параметр Boolean.

Если этот параметр имеет значение true, задача перезаписывает конечный каталог, если он уже существует. Все содержимое каталога будет утеряно. Значение по умолчанию — false. Этот параметр соответствует параметру командной строки -f для aspnet_compiler.exe.
KeyContainer Необязательный параметр String.

Задает контейнер ключа для строгого имени.
KeyFile Необязательный параметр String.

Указывает физический путь к файлу ключа для строгого имени.
MetabasePath Необязательный параметр String.

Указывает полный путь к метабазе IIS приложения. Этот параметр нельзя использовать вместе с параметром VirtualPath или PhysicalPath. Этот параметр соответствует параметру командной строки -m для aspnet_compiler.exe.
PhysicalPath Необязательный параметр String.

Указывает физический путь к компилируемому приложению. Если этот параметр отсутствует, для поиска приложения используется метабаза IIS. Этот параметр соответствует параметру командной строки -p для aspnet_compiler.exe.
TargetFrameworkMoniker Необязательный параметр String.

Задает параметр TargetFrameworkMoniker, который определяет используемую версию .NET Framework для aspnet_compiler.exe. Принимает только моникеры платформы .NET Framework.
TargetPath Необязательный параметр String.

Указывает физический путь, по которому компилируется приложение. Если этот параметр не указан, приложение предкомпилируется на месте.
Updateable Необязательный параметр Boolean.

Если этот параметр имеет значение true, то предкомпилированное приложения будет обновляемым. Значение по умолчанию — false. Этот параметр соответствует параметру командной строки -u для aspnet_compiler.exe.
VirtualPath Необязательный параметр String.

Виртуальный путь к компилируемому приложению. Если указан параметр PhysicalPath, для поиска приложения используется физический путь. В противном случае используется метабаза IIS, и предполагается, что приложение расположено в узле по умолчанию. Этот параметр соответствует параметру командной строки -v для aspnet_compiler.exe.

Параметры ToolTaskExtension

Эта задача наследуется от класса ToolTaskExtension, который наследуется от класса ToolTask, который, в свою очередь, наследуется от класса Task. Эта цепочка наследования добавляет несколько параметров в задачи, которые от них происходят.

В следующей таблице описываются параметры базовых классов:

Параметр Описание
EchoOff Необязательный параметр bool.

Если задано значение true, то задача передает /Q в командную строку cmd.exe и командная строка не копируется в stdout.
EnvironmentVariables Необязательный параметр массива String.

Массив определений переменных среды, разделенных точкой с запятой. Каждое определение должно содержать имя и значение переменной среды, разделенные знаком равенства. Эти переменные частично передаются в порожденный исполняемый файл, дополняя или выборочно переопределяя обычный блок среды. Например, Variable1=Value1;Variable2=Value2.
ExitCode Необязательный выходной параметр Int32, доступный только для чтения.

Задает код выхода, предоставляемый выполняемой командой. Если задача зарегистрировала какие-либо ошибки, но процесс имеет код выхода 0 (успешное завершение), этот параметр имеет значение -1.
LogStandardErrorAsError Необязательный параметр bool.

Если он имеет значение true, то все сообщения, полученные в стандартном потоке ошибок, регистрируются как ошибки.
StandardErrorImportance Необязательный параметр String.

степень важности, с которой текст из стандартного потока ошибок следует регистрировать в журнале.
StandardOutputImportance Необязательный параметр String.

Степень важности, с которой текст из стандартного выходного потока следует регистрировать в журнале.
Timeout Необязательный параметр Int32.

Задает промежуток времени в миллисекундах, после которого исполняемый файл задачи прекращается. Значение по умолчанию — Int.MaxValue. Оно указывает, что период ожидания отсутствует. Время ожидания в миллисекундах.
ToolExe Необязательный параметр string.

Он может реализовываться в проектах для переопределения параметра ToolName. Задачи могут переопределять его для сохранения параметра ToolName.
ToolPath Необязательный параметр string.

Указывает расположение, откуда задача загружает базовый исполняемый файл. Если этот параметр не задан, задача использует путь установки пакета SDK, соответствующий версии платформы, на которой выполняется MSBuild.
UseCommandProcessor Необязательный параметр bool.

Если задано значение true, эта задача создает пакетный файл для командной строки и выполняет его с помощью командного процессора вместо непосредственного выполнения команды.
YieldDuringToolExecution Необязательный параметр bool.

Если задано значение true, эта задача создает узел при выполнении его задачи.

пример

В следующем примере кода задача AspNetCompiler выполняет предварительную компиляцию приложения 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>

См. также