Ferramenta de compilação do ASP.NET (Aspnet_compiler.exe)

The ASP.NET Compilation tool (Aspnet_compiler.exe) enables you to compile an ASP.NET Web application, either in place or for deployment to a target location such as a production server. In-place compilation helps application performance because end users do not encounter a delay on the first request to the application while the application is compiled. Compilação para implantação pode ser executada em uma das duas maneiras: Remove todos os arquivos de fonte , como, por exemplo,-de code-behind e arquivos de marcação , ou que mantém os arquivos de marcação .

aspnet_compiler  [-?]
                 [-m metabasePath | -v virtualPath [-p physicalPath]]
                 [[-u] [-f] [-d] [-fixednames] targetDir]
                 [-c]
                 [-errorstack]
                 [-nologo]
                 [[-keyfile file | -keycontainer container ] [-aptca] [-delaysign]]

Options

Comentários

Existem duas versões do ASP.NET ferramenta de compilação:

• A versão que é fornecido com o .NET Framework 2.0. Use esta versão para aplicativos Web que são implantados em pools de aplicativo que estão associados a .NET Framework 2.0 CLR. Os aplicativos Web podem destino o .NET Framework 2.0, o .NET Framework 3.0, ou o .NET Framework 3.5.

• A versão que é fornecido com o .NET Framework 4. Use esta versão para aplicativos Web que são implantados em pools de aplicativo que estão associados a .NET Framework 4 CLR. Os aplicativos Web podem destino o .NET Framework 2.0, o .NET Framework 3.0, o .NET Framework 3.5, ou o .NET Framework 4. Quando esta versão é usado para Web sites de destino a .NET Framework 2.0, o .NET Framework 3.0, ou o .NET Framework 3.5, ele fornece melhor erro reporting em comparação com o .NET Framework 2.0 versão.

Para obter mais informações sobre como desenvolver, compilare implantarsitesWeb que versões específicas de destino do.NET Framework, consulte .NET Framework multiplataforma para projetos da Web do ASP.NET e Visão geral da execução lado a lado do ASP.NET. Para obter informações sobre como o ASP.NET ferramenta de compilação determina qual versão do.NET Framework um destinos de site da Web , consulte a BuildManager.TargetFramework propriedade.

ASP\ de ASP.NET ferramenta de compilação pode ser usada de duas maneiras gerais: para no lugar de-a compilação e compilação para implantação, onde o diretório de saída de destino é especificado. As seções a seguir descrevem esses cenários.

Compilar um aplicativo no local

ASP\ de ASP.NET compilação ferramenta pode compilar um aplicativo no local, ou seja, imita o comportamento de fazer várias solicitações para o aplicativo, fazendo com que a compilação regular. Usuários de um site pré-compilado não terão um atraso causado por compilar a página na primeira solicitação.

Observe que se você estiver usando uma conta representada, a conta e a conta de logon do usuário devem ter acesso de gravação para o destino de pré-compilação seja bem-sucedida.

Quando você pré-compila um site in-loco, os itens seguintes aplicar:

• O site mantém seus arquivos e a estruturade diretório.

• Você deve ter compiladores para todas as linguagens de programação usadas pelo site no servidor.

• Se qualquer arquivo falhar a compilação, o site inteiro falhará a compilação.

Você também pode recompilar um aplicativo no local depois de adicionar novos arquivos de fonte . A ferramenta compila somente os arquivos novos ou alterados, a menos que você incluir o -c opção.

Compilando um aplicativo para implantação

compilar um aplicativo para implantação (compilação para um local de destino ), especificando a targetDirparâmetro. O targetDir pode ser o local final para oaplicativode Webou aplicativo compilado pode ser ainda mais implantada.

Usando o -u opção compila o aplicativo de tal forma que você pode fazer alterações em certos arquivos no aplicativo compilado sem recompilar o proprietário. Aspnet_compiler. exe faz uma distinção entre estático e tipos de arquivos dinâmico e trata-los de maneira diferente ao criar o aplicativoresultante.

Tipos de arquivos estáticos são aqueles que não têm um compilador associado ou criar um provedor, como, por exemplo, arquivos cujos nomes têm extensões como. css,. gif,. htm,. HTML,. jpg,. js e assim por diante. Simplesmente, esses arquivos são copiados para o local de destino , com suas casas relativos na estrutura do diretório preservados.

Tipos de arquivo dinâmicos são aqueles que têm um compilador associado ou criar provedor, incluindo arquivos de ASP.NET-extensões de nome de arquivo específico como, por exemplo,. asax,. ascx,. ashx,. aspx,. browser,. master e assim por diante. ASP\ de ASP.NET ferramenta de compilação gera assemblies desses arquivos. Se a -u opção for omitida, a ferramenta também cria arquivos com a extensão de nome de arquivo.COMPILADO nesse mapa arquivos de fonte original ao seu assembly. Para garantir que a estrutura do diretório de aplicativofonte é preservado, a ferramenta gera o arquivos do espaço reservado nos locais correspondentes noaplicativode destino.

Você deve usar o -u opção para indicar que o conteúdo do aplicativo compilado pode ser modificado. Caso contrário, as modificações subseqüentes são ignoradas ou causam erros em tempo de execução-.

A tabela a seguir descreve como o ASP.NET tipos de arquivo diferente de alças de ferramenta de compilação quando o -u opção está incluída.

File type	Ação do compilador
. ascx,. aspx,. master	Esses arquivos são divididos em marcação e código fonte , que inclui o código de-por trás de arquivos. Código-fonte é compilado em conjuntos de módulos com nomes que são derivados de um algoritmode hash, e os assemblies são colocados no diretório Bin. Qualquer código embutido , que é, o código incluído em <script runat="server"> elementos, está incluído com marcação e não compilado. Arquivos deNovo com o mesmo nome que os arquivos de fonte são criados para conter a marcação e colocados nos diretórios de saída correspondente.
. ashx,. asmx	Esses arquivos não são compilados e são movidos para os diretórios de saída, como é e não compilado. Se você deseja ter o código de manipulador compilado, coloque o código em arquivos de código fonte no diretório App_Code.
. cs,. vb,. jsl,. cpp (não incluindo-de código por trás de arquivos para tipos de arquivo listados anteriormente)	Esses arquivos são compilados e incluídos como um recurso em assemblies que fazem referência a eles. Arquivos de origem não são copiados para o diretório de saída. Se um arquivo de código não é referenciado, ele não é compilado.
Tipos de arquivoPersonalizar	Esses arquivos não são compilados. Esses arquivos são copiados para os diretórios de saída correspondente.
Arquivos de código-fonte na subpasta App_Code	Esses arquivos são compilados em assemblies e colocados no diretório Bin. Observação Tipos de arquivo estático no diretório App_Code não são copiados para os diretórios de saída.
. resx e.arquivos derecurso no subdiretório App_GlobalResources	Esses arquivos são compilados em assemblies e colocados no diretório Bin. Não Subdiretório App_GlobalResources é criado sob o diretório de saída principal, e nenhum arquivo. resx ou. Resources, localizado no diretório de fonte é copiado para os diretórios de saída. Observação Os arquivos de recurso no subdiretório App_GlobalResources são compilados em assemblies antes que o código no subdiretório App_Code é compilado.Modificação dos arquivos de recurso após a compilação não é suportada.
. resx e.arquivos derecurso no subdiretório App_LocalResources	Esses arquivos não são compilados e são copiados para os diretórios de saída correspondente.
.arquivos decapa no subdiretório App_Themes	A.arquivos decapa e arquivos detema estáticonão são compilados e são copiados para os diretórios de saída correspondente.
.browser Web.config Tipos de arquivo estático Módulos (assemblies) já está presente no diretório Bin	Esses arquivos são copiados para os diretórios de saída.

A tabela a seguir descreve como o ASP.NET tipos de arquivo diferente de alças de ferramenta de compilação quando o -u opção for omitida.

File type	Ação do compilador
. aspx,. asmx,. ashx,. master	Esses arquivos são divididos em marcação e código fonte , que inclui-de código por trás de arquivos e de qualquer código que está incluído em <script runat="server"> elementos. Código-fonte é compilado em conjuntos de módulos com nomes que são derivados de um algoritmode hash. Os assemblies resultantes são colocados no diretório Bin. Qualquer código embutido , que é, o código entre o <% e %> colchetes, está incluído com marcação e não compilado. O compilador cria novos arquivos para conter a marcação com o mesmo nome que os arquivos de fonte . Esses arquivos resultantes são colocados no diretório Bin. O compilador também cria arquivos com o mesmo nome que os arquivos de fonte , mas com a extensão .COMPILED que contêm informações de mapeamento . A.Arquivos COMPILADOS são colocados nos diretórios de saída correspondente ao local original dos arquivos de fonte .
.ascx	Esses arquivos são divididos em marcação e código fonte . Código-fonte é compilado em assemblies e colocado no diretório Bin, com nomes que são derivados de um algoritmode hash. Nãoarquivos demarcação são gerados.
. cs,. vb,. jsl,. cpp (não incluindo-de código por trás de arquivos para tipos de arquivo listados anteriormente)	Código-fonte que é referenciado por assemblies gerados a partir de arquivos. aspx,. ashx ou. ascx é compilado em assemblies e colocado no diretório Bin. Nãoos arquivos defonte são copiados.
Tipos de arquivoPersonalizar	Esses arquivos são compilados como arquivos dinâmicos. Dependendo do tipo de arquivo que se baseiam, o compilador pode colocar os arquivos de mapeamento nos diretórios de saída.
Arquivos no subdiretório App_Code	Arquivos de código-fonte nesse subdiretório são compilados em assemblies e colocados no diretório Bin. Observação Tipos de arquivo estático no diretório App_Code não são copiados para os diretórios de saída.
Arquivos no subdiretório App_GlobalResources	Esses arquivos são compilados em assemblies e colocados no diretório Bin. Não Subdiretório App_GlobalResources é criado sob o diretório de saída principal. Se o arquivo de configuração especifica appliesTo="All", os arquivos. resx e. Resources são copiados para os diretórios de saída. Não são copiados se eles são referenciados por uma BuildProvider.
. resx e.arquivos derecurso no subdiretório App_LocalResources	Esses arquivos são compilados em assemblies com nomes exclusivos e colocados no diretório Bin. . Resx deNão ou.arquivos derecurso são copiados para os diretórios de saída.
.arquivos decapa no subdiretório App_Themes	Temas são compilados em assemblies e colocados no diretório Bin. Arquivos de stub são criados para.arquivos decapa e colocado no diretório de saída correspondente. Arquivos estáticos (como. CSS) são copiados para os diretórios de saída.
.browser Web.config Tipos de arquivo estático Módulos (assemblies) já está presente no diretório Bin	Esses arquivos são copiados para o diretório de saída.

Nomes de Assembly fixos

Alguns cenários, tais como implantar umaplicativo de Webusando o MSI Windows Installer, exigem o uso de nomes de arquivo consistente e conteúdo, bem como estruturas de diretório consistentes para identificar os assemblies ou definições de configuração para atualizações. Nesses casos, você pode usar o -fixednames a opção de especificar que o ASP.NET ferramenta de compilação deve compilar um assembly para cada arquivo de fonte em vez de usar onde várias páginas são compiladas em assemblies. Isso pode levar a um grande número de assemblies, portanto, se você estiver preocupado com a escalabilidade você deve usar essa opção com cuidado.

Forte-Nome Compilação

O -aptca, -delaysign, -keycontainer e -keyfile as opções são fornecidas para que você possa usar Aspnet_compiler. exe para criar conjuntos nomeados altamente sem usar o Sn. exe (ferramenta de nome forte) separadamente. Essas opções correspondem, respectivamente, em AllowPartiallyTrustedCallersAttribute, AssemblyDelaySignAttribute, AssemblyKeyNameAttribute, e AssemblyKeyFileAttribute. Como cada opção aplica-se o atributo correspondente para o assemblycompilado e os atributos são marcados com um AttributeUsageAttribute cujo AllowMultiple propriedade false, usando essas chaves no código fonte , que já foi marcada com um desses atributos faz com que a compilação a falhar.

ASP\ de ASP.NET Classes

Várias classes na System.Web.Compilation namespace habilitar seu código acessar ou chamar Aspnet_compiler. exe fora do ambientede IIS. O ClientBuildManager classe fornece o PrecompileApplication método para compilar um aplicativo. O ClientBuildManager classe também funciona com o ClientBuildManagerParameter classe, que permite que você especifique PrecompilationFlags que correspondem às opções usadas por esta ferramenta e da mesma forma, para especificar chaves de nome forte .

Examples

O comando a seguir compila o aplicativo WebApplication1 no lugar:

Aspnet_compiler -v /WebApplication1

O comando a seguir compila o aplicativo WebApplication1 no lugar e a ferramenta adiciona informações de rastreamento de pilha se ele deve relatório erros.

Aspnet_compiler -v /WebApplication1 -errorstack

O comando a seguir compila o aplicativo WebApplication1 para implantação, usando o caminho do diretório físico. Ele também adiciona dois atributos para os assemblies de saída. Ele usa o -keyfile opção para adicionar um AssemblyKeyFileAttribute atributo, que especifica que o arquivo Key.sn contém as informações de par público/particular chave que a ferramenta deve usar para fornecer nomes de alta segurança para os assemblies gerados. O comando também usa o -aptca opção para adicionar um AllowPartiallyTrustedCallersAttributedeatributo para assemblies gerados. Webaplicativo compilado é criado no c:\applicationTarget diretório.

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

O comando a seguir compila o serviço de WebService2 no caminho de metabase padrão, substituindo o diretório de destino do SampleWebService do aplicativocompilado.

Aspnet_compiler -m /LM/W3SVC/1/ROOT/WebService2 -f c:\InetPub\wwwroot\SampleWebService

Localizando a versão correta do Aspnet_compiler. exe

A ferramenta Aspnet_compiler. exe é instalada no Microsoft.NET Framework directory. Se o computador estiver executando vários.NET Framework versões lado a-pelo lado de-, várias versões da ferramenta podem ser instaladas. A tabela a seguir lista os locais onde a ferramenta está instalada para versões diferentes do.NET Framework.

Consulte também

Referência

AssemblyKeyFileAttribute

AssemblyKeyNameAttribute

AssemblyDelaySignAttribute

AllowPartiallyTrustedCallersAttribute

Sn. exe (ferramenta de nome forte)

Ferramenta de registro ASP.NET IIS (Aspnet_regiis.exe)

BuildManager.TargetFramework

Conceitos

Atraso na Assinatura de um Assembly

Assemblies de nomes fortes

.NET Framework multiplataforma para projetos da Web do ASP.NET

Visão geral da execução lado a lado do ASP.NET

Outros recursos

Ferramentas.NET Framework