Программа компиляции для ASP.NET (Aspnet_compiler.exe)
Обновлен: Ноябрь 2007
Программа компиляции для ASP.NET (Aspnet_compiler.exe) позволяет компилировать веб-приложение ASP.NET, на месте или для развертывания в целевом размещении, таких как сервер приложения. Компиляция на месте повышает производительность приложения, т.к. конечные пользователи не сталкиваются с задержкой при первом обращении к приложению, пока приложение компилируется.
Компиляция для развертывания может быть выполнена одним из двух способов: один удаляет все исходные файлы, например код программной части и файлы разметки, другой сохраняет файлы разметки.
.gif "Примечание") Примечание. |
|---|
Программа компиляции для ASP.NET не доступна с версиями ASP.NET ранее версии 2.0. |
aspnet_compiler [-?]
[-m metabasePath | -v virtualPath [-p physicalPath]]
[[-u] [-f] [-d] [-fixednames] targetDir]
[-c]
[-errorstack]
[-nologo]
[[-keyfile file | -keycontainer container ] [-aptca] [-delaysign]]
Параметры
Параметр |
Описание |
|---|---|
-m metabasePath |
Задает полный путь к метабазе IIS приложения для компиляции. Метабаза IIS является хранилищем иерархической информации, используемой для конфигурирования IIS. Например, путь метаданных к веб-сайту IIS по умолчанию — LM/W3SVC/1/ROOT. Данный параметр несовместим с параметрами -v или -p. |
-v virtualPath |
Задает виртуальный путь к компилируемому приложению. Если также указан параметр -p, значение сопровождающего параметра physicalPath используется для обнаружения компилируемого приложения. В противном случае используется метабаза IIS, и программа считает, что файлы источника расположены под веб-сайтом по умолчанию (указанном в узле метабазы LM/W3SVC/1/ROOT). Параметр не может использоваться вместе с параметром -m. |
-p physicalPath |
Задает полный сетевой или локальный дисковый путь к корневому каталогу, содержащему приложение для компиляции. Если не задан аргумент -p, для поиска каталога используется метабаза IIS. Этот параметр должен быть объединен с параметром -v, и не может использоваться с параметром -m. |
-u |
Указывает, что программа Aspnet_compiler.exe должна создавать предкомпилированное приложение, позволяющее использовать последующие обновления содержимого, например ASPX-страниц. Если данный параметр опущен, полученное приложение содержит только скомпилированные файлы и не может быть обновлено на сервере развертывания. Обновить приложение можно только путем изменения исходных файлов разметки и перекомпиляции. Параметр targetDir должен присутствовать. |
-f |
Указывает, что программа должна переписать существующие файлы в каталоге targetDir и его подкаталогами. |
-d |
Переопределяет установки, определенные в исходных файлах конфигурации приложения, чтобы принудительно включить отладочную информацию в компилированное приложение. В противном случае вывод отладочной информации опускается. Нельзя использовать параметр -d для компиляции на месте. Такая компиляция выполняет установки конфигурации для параметров отладки. |
targetDir |
Сетевой или локальный дисковый путь к корневому каталогу, который будет содержать компилированное приложение. Если параметр targetDir не указан, приложение компилируется на месте. |
-c |
Указывает, что компилируемое приложение должно быть полностью перестроено. Ранее компилированные компоненты компилируются снова. Если этот параметр опущен, инструмент выполняет построение только тех компонентов приложения, которые были изменены со времени предыдущей компиляции. |
-errorstack |
Указывает, что программа должна включить информацию трассировки стека, если компиляция приложения не удалась. |
-keyfile file |
Указывает, что атрибут AssemblyKeyFileAttribute, задающий имя файла, содержащего пару открытый/закрытый ключ, используемую для создания строгого имени, должен быть применен к компилируемой сборке. Этот параметр необходимо использовать совместно с параметром -aptca. Если параметр уже применен к сборке файлов исходного текста, программа Aspnet_compiler.exe вызывает исключение. |
-keycontainer container |
Указывает, что атрибут AssemblyKeyNameAttribute задающий имя контейнера для пары открытый/закрытый ключ, используемую для создания строгого имени, должен быть применен к компилируемой сборке. Этот параметр необходимо использовать совместно с параметром -aptca. Если параметр уже применен к сборке файлов исходного текста, программа Aspnet_compiler.exe вызывает исключение. |
-aptca |
Указывает, что атрибут AllowPartiallyTrustedCallersAttribute, позволяющий частично доверенному вызывающему получать доступ к сборке, должен быть применен к сборке со строгим именем, которую создает Aspnet_compiler.exe. Этот параметр необходимо использовать совместно с параметром -keyfile или -keycontainer. Если параметр уже применен к сборке файлов исходного текста, программа Aspnet_compiler.exe вызывает исключение. |
-delaysign |
Указывает, что атрибут AssemblyDelaySignAttribute, определяющий, что сборка должна быть подписана только маркером открытого ключа, а не парой открытый/закрытый ключ, должен быть применен к создаваемой сборке. Этот параметр необходимо использовать совместно с параметром -keyfile или -keycontainer. Если параметр уже применен к сборке файлов исходного текста, программа Aspnet_compiler.exe вызывает исключение. При использовании параметра -delaysign, код, создаваемый программой Aspnet_compilier.exe, может быть запущен до подписи кода. Необходимо обеспечить защищенность кода от пользователей-злоумышленников, пока не выполнена подпись. |
-fixednames |
Указывает, что одна сборка должна создаваться для каждой страницы в приложении. Каждая сборка получает имя с виртуальным путем исходной страницы, за исключением случая превышения предела операционной системы на имена файлов, в котором создается хэш и используется в качестве имени сборки. Нельзя использовать параметр -fixednames для компиляции на месте; такая компиляция использует установки конфигурации для пакетного режима компиляции. |
-nologo |
Отменяет вывод уведомления об авторских правах. |
-? |
Отображает синтаксис команд и параметров программы. |
Заметки
Программа компиляции для ASP.NET может быть использована двумя способами: для компиляции на месте и для компиляции для развертывания, при которой указывается целевой выходной каталог. Эти сценарии описаны в следующих разделах.
Компилирование приложения на месте
Программа компиляции для ASP.NET может компилировать приложение на месте, т.е. она имитирует поведение, связанное с выполнением нескольких запросов к приложению, что приводит к выполнению обычной компиляции. Пользователь предкомпилированного сайта не ощутит задержки, вызываемой компиляцией страницы при первом запросе.
Обратите внимание, что при использовании олицетворенной учетной записи, данная учетная запись и учетная запись пользователя для входа в систему должны иметь доступ на запись, чтобы могла быть выполнена компиляция.
При предварительном компилировании сайта на месте действительно следующее:
Сайт сохраняет свою структуру файлов и каталогов.
Необходимо наличие компиляторов для всех языков программирования, используемых сайтом на сервере.
Если происходит сбой компиляции любого файла, компиляция всего сайта является неудачной.
Также можно выполнить повторную компиляцию приложения на месте после добавления к нему новых исходных файлов. Программа компилирует только новые или измененные файлы, за исключением случаев, когда используется параметр -c.
| Примечание. |
|---|
Компиляция приложения, содержащего вложенное приложение, не компилирует вложенное приложение. Вложенное приложение должно быть откомпилировано отдельно. |
| Примечание. |
|---|
При компиляции веб-приложения, содержащего главные страницы, возможен сбой компиляции, если приложение компилируется как обновляемый сайт, и происходит конфликт названий. Конфликт может произойти, если имя главной страницы совпадает с именем пространства имен для страницы содержимого, производной от главной страницы. (Отношения наследования могут быть определены атрибутом Inherits директивы @ Page). Чтобы устранить эту проблему, можно либо изменить имя класса главной страницы, либо имя в пространстве имен, либо можно компилировать приложение как необновляемое. |
Компилирование приложения для развертывания.
Можно выполнить компиляцию приложения для развертывания (компиляция в целевое размещение) путем указания параметра targetDir. Параметр targetDir может быть окончательным расположением для веб-приложения, либо компилированное приложение может быть развернуто далее.
Использование параметра -u компилирует приложение таким образом, чтобы можно было изменить определенные файлы в компилированном приложении без его повторной компиляции. Программа Aspnet_compiler.exe различает статические и динамические типы файлов, и обрабатывает их по разному при создании результирующего приложения.
Статические типы файлов — это те, которые не имеют связанного компилятора или поставщика компоновки, например файлы с расширениями CSS, GIF, HTM, HTML, JPG, JS и т.п. Эти файлы просто копируются в целевое размещение, с сохранением относительных положений в структуре каталогов.
Динамические типы файлов — это те, которые имеют связанный компилятор или поставщик компоновки, включая файлы с расширениями для ASP.NET, например ASAX, ASCX, ASHX, ASPX, BROWSER, MASTER и т.п. Программа компиляции для ASP.NET создает сборки на основе этих файлов. Если параметр -u опущен, программа также создает файлы с расширением COMPILED, сопоставляющие исходные файлы сборке. Чтобы обеспечить сохранение структуры каталогов источника приложения, программа создает файлы-местозаполнители в соответствующих расположениях в целевом приложении.
Необходимо использовать параметр -u для указания, что содержимое компилированного приложения может быть изменено. В противном случае, последующие изменения игнорируются или вызывают ошибки времени исполнения.
В следующей таблице описано, как программа компиляции для ASP.NET обрабатывает различные типы файлов при использовании параметра -u.
Тип файла |
Действие компилятора |
|---|---|
.ASCX, ASPX, MASTER |
Эти файлы разделяются на разметку и исходный код, содержащие файлы кода программной части. Исходный файл компилируется в сборки, имена которых получены с помощью алгоритма хэширования, и сборки размещаются в каталоге Bin. Любой встроенный код, т.е. код, заключенный в элементы <script runat="server"> относится к разметке и не компилируется. Новые файлы с тем же именем, что и исходные файлы, создаются для содержания разметки и помещаются в соответствующие выходные каталоги. |
.ASHX, ASMX |
Эти файлы не компилируются и перемещаются в выходные каталоги "как есть", без компиляции. Если требуется компилировать код обработки, поместите его в файлы исходного кода в каталоге App_Code. |
.CS, VB, JSL, CPP (за исключением файлов кода программной части для типов для типов файлов, приведенных выше) |
Эти файлы компилируются и включаются в качестве ресурсов в сборки, которые на них ссылаются. Исходные файлы не копируются в выходной каталог. Если на файл кода нет ссылки, он не компилируется. |
Пользовательские типы файлов |
Эти файлы не компилируются. Эти файлы копируются в соответствующие выходные каталоги. |
Файлы исходного кода в подкаталоге App_Code. |
Эти файлы компилируются в сборки и размещаются в каталог Bin. Примечание.
Статические типы файлов в каталоге App_Code не копируются в выходные каталоги.
|
.Файлы с расширениями RESX и RESOURCE в подкаталоге App_GlobalResources |
Эти файлы компилируются в сборки и размещаются в каталог Bin. Подкаталог App_GlobalResources не создается в главном выходном каталоге, и файлы с расширениями RESX и RESOURCES из исходного каталога не копируются в выходные каталоги. Примечание.
Файлы ресурсов в подкаталоге App_GlobalResources компилируются в сборки до компиляции кода в подкаталоге App_Code. Модификация файлов ресурсов после компиляции не поддерживается.
|
.Файлы с расширениями RESX и RESOURCE в подкаталоге App_LocalResources |
Эти файлы не компилируются и копируются в соответствующие выходные каталоги. |
.Файлы обложки в подкаталоге App_Themes |
Файлы с расширением SKIN и статические файлы тем не компилируются и копируются в соответствующие выходные каталоги. |
.обозреватель Файл Web.config Статические типы файлов Сборки уже существуют в каталоге Bin |
Эти файлы копируются "как есть" в выходные каталоги. |
В следующей таблице описывается обработка различных типов файлов программой компиляции для ASP.NET, если параметр -u опущен.
| Примечание. |
|---|
Не подается никаких предупреждений, предотвращающих изменения исходного кода скомпилированного приложения. |
Тип файла |
Действие компилятора |
|---|---|
.ASPX, ASMX, ASHX, MASTER |
Эти файлы разделены на разметку и исходный код, содержащие файлы кода программной части и любой код, заключенный в элементы <script runat="server">. Исходный файл компилируется в сборки, имена которых получены с помощью алгоритма хэширования. Полученные сборки размещаются в каталоге Bin. Любой встроенный код, т.е. код, заключенный в скобки <% и %>, относится к разметке и не компилируется. Компилятор создает новые файлы для содержания разметки с тем же именем, что и исходные файлы. Полученные файлы размещаются в каталоге Bin. Компилятор также создает файлы с тем же именем, что и исходные файлы, но с расширением COMPILED, содержащие данные сопоставления. Файлы с расширением COMPILED размещаются в выходные каталоги, соответствующие расположениям исходных файлов. |
.ASCX |
Эти файлы разделяются на разметку и исходный код. Исходный код компилируется в сборки и размещается в каталоге Bin, с именами, полученные с помощью алгоритма хэширования. Файлы разметки не создаются. |
.CS, VB, JSL, CPP (за исключением файлов кода программной части для типов для типов файлов, приведенных выше) |
Исходный код, на который ссылаются сборки, созданные на основе файлов ASCX, ASHX, или ASPX компилируется в сборки и размещается в каталоге Bin. Исходные файлы не копируются. |
Пользовательские типы файлов |
Эти файлы компилируются как динамические. В зависимости от типа файла, на котором они основаны, компилятор может разместить файлы сопоставления в выходные каталоги. |
Файлы в подкаталоге App_Code |
Файлы исходного кода в данном подкаталоге компилируются в сборки и размещаются в подкаталоге Bin. Примечание.
Статические типы файлов в каталоге App_Code не копируются в выходные каталоги.
|
Файлы в подкаталоге App_GlobalResources |
Эти файлы компилируются в сборки и размещаются в каталог Bin. В главном выходном каталоге подкаталог App_GlobalResources не создается. Если файлы конфигурации задают appliesTo="All", файлы с расширением RESX и RESOURCES копируются в выходные каталоги. Они не копируются, если на них существуют ссылки BuildProvider. |
.Файлы с расширениями RESX и RESOURCE в подкаталоге App_LocalResources |
Эти файлы компилируются в сборки с уникальными именами и размещаются в каталог Bin. Файлы с расширениями RESX или RESOURCE не копируются в выходные каталоги. |
.Файлы обложки в подкаталоге App_Themes |
Темы компилируются в сборки и размещаются в каталог Bin. Файлы-заглушки создаются для файлов с расширением SKIN и помещаются в соответствующий выходной каталог. Статистические файлы (такие как .css) копируются в выходные каталоги. |
.обозреватель Файл Web.config Статические типы файлов Сборки уже существуют в каталоге Bin |
Эти файлы копируются "как есть" в выходной каталог. |
Фиксированные имена сборок
Некоторые сценарии, например развертывание веб-приложения с помощью установщика Windows, требуют использования согласованных имен файлов и содержимого, а также согласованных структур каталогов для указания сборок или установок конфигурация для обновлений. В таких случаях можно использовать параметр -fixednames для указания программе компиляции для ASP.NET, что требуется компилировать сборку для каждого исходного файла, вместо использования режима компилирования нескольких страниц в сборки. Это может привести к большому количеству сборок, поэтому, если важна масштабируемость, этот параметр следует использовать с осторожностью.
Компиляция со строгим именем
Параметры -aptca, -delaysign, -keycontainer и -keyfile предоставлены для того, чтобы можно было использовать программу Aspnet_compiler.exe для создания сборок со строгими именами без использования программы Средство строгих имен (Sn.exe) отдельно. Эти параметры соответствуют AllowPartiallyTrustedCallersAttribute, AssemblyDelaySignAttribute, AssemblyKeyNameAttribute и AssemblyKeyFileAttribute соответственно. Т.к. каждый параметр применяет соответствующий атрибут к компилируемой сборке, и так как параметры помечены атрибутом AttributeUsageAttribute, свойство AllowMultiple которого установлено на значение false, использование этих ключей в исходном коде, который уже был помечен одним из этих атрибутов, приводит к сбою компиляции.
Связанные классы ASP.NET
Некоторые классы в пространстве имен System.Web.Compilation позволяют коду получать доступ или вызывать программу Aspnet_compiler.exe вне среды IIS. Класс ClientBuildManager предоставляет PrecompileApplication метод для компиляции приложения. Класс ClientBuildManager также работает с классом ClientBuildManagerParameter позволяющим указать PrecompilationFlags, соответствующий параметрам, используемым данной программой, и аналогично указать ключи строгого имени.
Примеры
Следующая команда компилирует приложение WebApplication1 на месте:
Aspnet_compiler -v /WebApplication1
Следующая команда компилирует приложение WebApplication1 на месте, и программа добавляет данные трассировки стека, если требуется сообщить об ошибке.
Aspnet_compiler -v /WebApplication1 -errorstack
Следующая команда компилирует приложение WebApplication1 для развертывания, используя физический путь каталога. Она также добавляет два атрибута в выводимые сборки. Она использует параметр -keyfile для добавления атрибута AssemblyKeyFileAttribute, который указывает, что файл Key.sn, содержащий данные пары открытый/закрытый ключ, который программа должна использовать для предоставления строгих имен для создаваемых сборок. Команда также использует параметр -aptca для добавления атрибута AllowPartiallyTrustedCallersAttribute в создаваемые сборки. Скомпилированное веб-приложение создается в каталоге c:\applicationTarget.
Aspnet_compiler -v /WebApplication1 -p "c:\Documents and Settings\Default\My Documents\MyWebApplications\WebApplication1" -keyfile "c:\Documents and Settings\Default\My Documents\Key.sn" -aptca c:\applicationTarget
Следующая команда компилирует службу WebService2 по пути метабазы по умолчанию, перезаписывая целевой каталог SampleWebService компилируемым приложением.
Aspnet_compiler -m /LM/W3SVC/1/ROOT/WebService2 -f c:\InetPub\wwwroot\SampleWebService
См. также
Основные понятия
Ссылки
AllowPartiallyTrustedCallersAttribute