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>