Elemento compilation (Esquema de configurações ASP.NET)

Artigo
08/25/2010

Configura todas as configurações de compilação que o ASP.NET usa para compilar aplicativos.

<configuration> Element
System.Web elemento (esquema configurações ASP.NET)
Elemento compilation (Esquema de configurações ASP.NET)

<compilation 
   debug="[true|false]"
   batch="[true|false]"
   batchTimeout="number of seconds"
   defaultLanguage="language" 
   explicit="[true|false]" 
   maxBatchSize="maximim number of pages"
   maxBatchGeneratedFileSize="maximum combined size"
   numRecompilesBeforeAppRestart="number"
   strict="[true|false]" 
   tempDirectory="temporary files directory"
   urlLinePragmas="[true|false]"
   assemblyPostProcessorType="assembly post processor, assembly"
>
   <assemblies>...</assemblies> 
   <buildproviders>...</buildproviders>
   <codeSubDirectories>...</codeSubDirectories>
   <compilers>...</compilers>
   <expressionBuilders>...</expressionBuilders>
</compilation>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo	Descrição
assemblyPostProcessorType	Opcional String atributo. Especifica uma etapa de compilação após processos para um assembly, fazendo referência ao post-processador assembly. Use the format "assembly post processor, assembly". The processador de POST de assembly deve implementar o IAssemblyPostProcessor interface. Usando esse método de pós-processamento força depurar na compilação, o que você pode substituir ao especificar o modo de implantação. Esse atributo é novo no .NET estrutura versão 2.0. O padrão é uma seqüência de caracteres vazia.
batch	Opcional Boolean atributo. Indica se a geração de envio em lote é aceita. If True, elimina o atraso causado pela compilação necessária quando você acesso um arquivo pela primeira vez. Quando esse atributo é definido como True, ASP.NET pré-compila todos os arquivos não compilados em um modo lote, que faz com que um time de atraso na primeira ainda mais que os arquivos são compilados. No entanto, após esse atraso inicial, o atraso de compilação é eliminado no acesso subseqüente do arquivo. O padrão é True.
batchTimeout	Opcional TimeSpan atributo. Especifica o período de time limite em segundos, para compilação lote. Se a compilação não pode ser concluída dentro do período de time limite, o compilador reverte para o modo de compilação única para a página corrente. O padrão é "900" (15 minutos).
debug	Opcional Boolean atributo. Especifica se a compilar de binários de depurar em vez de binários de varejo. O padrão é False.
defaultLanguage	Opcional String atributo. Especifica a linguagem, sistema autônomo de programação padrão"C#"ou "PERL", para usar em arquivos de compilação dinâmica. Nomes de idiomas são definidos usando ambos o compiladores elemento de do sistema.codeDom o ou seçãocompiladores o elemento filho desse elemento (obsoleto). O padrão é "vb".
explicit	Opcional Boolean atributo. Especifica se deve conjunto o Microsoft Visual Basic explicit opção de compilar. If True, todas as variáveis devem ser declaradas usando um Dim, Private, Public, ou ReDim demonstrativo. O padrão é True.
maxBatchGeneratedFileSize	Opcional Int32 atributo. Especifica o dimensionar máximo combinado (em KB) dos arquivos de fonte gerados por compilação em lote. Em geral, não é ideal carregar um assembly enorme na memória quando na verdade, são necessários menos bits. Esse limite ajuda para certificar-se de que o dimensionar dos assemblies se encaixam em uma gama razoável para que o aplicativo aproveita o mecanismo de lote sem a sobrecarga do sistema. Isso é semelhante a maxBatchSize. O padrão é 1000.
maxBatchSize	Opcional Int32 atributo. Especifica o número máximo de páginas por compilação em lote. O padrão é 1000.
numRecompilesBeforeAppRestart	Opcional Int32 atributo. Especifica o número de recompilações dinâmicas de recursos que podem ocorrer antes da reinicialização do aplicativo. Há suporte para esse atributo no nível de global e de aplicativo, mas não no nível do diretório. Observação: ASP.NET aumenta a NumRecompilesBeforeAppRestart propriedade toda vez que um assembly é invalidado e Falha ao ser excluído. O padrão é 15.
strict	Opcional Boolean atributo. Especifica se deve ser ativado o Visual Basic strict opção de compilar. O padrão é False.
tempDirectory	Opcional String atributo. Especifica o diretório a ser usada para armazenamento de arquivos temporários durante a compilação. The default is an empty string (""). No caso de uma seqüência vazia, e se o processo corrente tiver as permissões de acesso necessários, os arquivos são armazenados na %FrameworkInstallLocation%\ Diretório temporário do ASP.NET Files. Observe que somente processos com permissões de confiança alto podem acessar o %FrameworkInstallLocation%\ Arquivos ASP.NET temporários.
urlLinePragmas	Opcional Boolean atributo. Especifica se o compilador deve usar URLs em vez de caminhos físicos. O padrão é False.

Elementos filho

Elemento	Descrição
assemblies	Define uma coleção de nomes de módulos (assemblies) que é usados durante a compilação de um recurso do ASP.NET.
buildproviders	Define uma coleção de provedores de compilação que são usados para compilar arquivos de recurso personalizados. Esse elemento é novo no .NET Framework versão 2.0.
codeSubDirectories	Define uma coleção ordenada de subdiretórios que contém os arquivos são compilados em time de execução. Esse elemento é novo no .NET Framework versão 2.0.
compilers	Define um conjunto de opções do compilador. Observação: No .NET estrutura versão 2.0, esse elemento é preterido em favor das compiladores elemento de do sistema.codeDom seção.No entanto, usando o compilers elemento filho das compilation o elemento é válido ainda e substitui o compilers elemento que está localizado na system.codedom seção.
expressionBuilders	Define uma coleção de seqüências de caracteres de recurso a ser usado durante a compilação. As cadeias de recursos associe prefixos construtores de expressão. Esse elemento é novo no .NET Framework versão 2.0.

Elementos pai

Elemento	Descrição
configuration	Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e aplicativos do .NET estrutura.
system.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar o comportamento de aplicativos da Web do ASP.NET.

Comentários

The compilation elemento configura todas as configurações de compilação que o ASP.NET usa para compilar aplicativos.

No .NET estrutura versão 2.0, a compilers elemento filho das compilation elemento é substituído pela compiladores elemento de do sistema.codeDom seção. No entanto, usando o compilers elemento filho das compilation o elemento é válido ainda e substitui o compilers elemento que está localizado na system.codedom seção.

Configuração padrão

O seguinte padrão compilation elemento não está configurado explicitamente na computador. arquivo de configuração ou na Web raiz. arquivo de configuração. No entanto, é a configuração padrão retornada pelo aplicativo. Itens são adicionados à módulos (assemblies), buildProviders, and expressionBuilders coleções da Web raiz. arquivo de configuração.

<compilation 
   tempDirectory="" 
   debug="false" 
   strict="false" 
   explicit="true" 
   batch="true" 
   batchTimeout="900" 
   maxBatchSize="1000" 
   maxBatchGeneratedFileSize="1000" 
   numRecompilesBeforeAppRestart="15" 
   defaultLanguage="vb" 
   urlLinePragmas="false" 
   assemblyPostProcessorType=""
>
   <assemblies>
       <clear />
   </assemblies>
   <buildProviders>
       <clear />
   </buildProviders>
   <expressionBuilders>
       <clear />
   </expressionBuilders>
</compilation>

O seguinte elemento de compilação padrão é configurado no arquivo computador.config no .NET estrutura versão 1.1. Existem configurações semelhantes no .NET estrutura versão 1.0, com exceção dos números de versão.

<compilation debug="false" explicit="true" defaultLanguage="vb">
   <compilers>
      <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" warningLevel="1"/>
      <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <compiler language="VJ#;VJS;VJSharp" extension=".jsl" type="Microsoft.VJSharp.VJSharpCodeProvider, VJSharpCodeProvider, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/></compilers>
   <assemblies>
      <add assembly="mscorlib"/>
      <add assembly="System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Web, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Data, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Web.Services, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Xml, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Drawing, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.EnterpriseServices, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Web.Mobile, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="*"/>
   </assemblies>
</compilation>

Exemplo

O exemplo de código a seguir demonstra como configurar as configurações de compilação de um aplicativo.

<configuration>
   <system.web>
      <compilation defaultLanguage="VB"
         debug="true"
         numRecompilesBeforeAppRestart="15">
         <compilers>
            <compiler 
               language="VB;VBScript"
               extension=".cls"
               type="Microsoft.VisualBasic.VBCodeProvider,system,     
                     Version=1.0.5000.0, Culture=neutral, 
                     PublicKeyToken=b77a5c561934e089"/>
            <compiler 
               language="C#;Csharp"
               extension=".cs"
               type="Microsoft.CSharp.CSharpCodeProvider,system, 
                     Version=1.0.5000.0,  Culture=neutral, 
                     PublicKeyToken=b77a5c561934e089"/>
         </compilers>
         <assemblies>
            <add assembly="ADODB"/>
            <add assembly="*"/>
         </assemblies>

         <codeSubDirectories>
           <add directoryName="mySubDir1"/>
           <add directoryName="mySubDir2"/>
           <add directoryName="mySubDir3"/>
         </codeSubDirectories>


         <buildProviders>
            <buildProvider 
               extension=".mafx" type="BuildProviderType, 
                          BuildProviderAssembly"
            />
        </buildProviders>
     </compilation>
   </system.web>
</configuration>

Informações do elemento

Manipulador de seção de configuração	CompilationSection
Configuração de membro	Compilation
Locais configuráveis	Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) 5.0, 5.1 ou 6.0 .NET estrutura 1.0, 1.1, 2.0 O Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Partilhar via

Elemento compilation (Esquema de configurações ASP.NET)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais