Elemento compiler aplicado a compilers para compilation (Esquema de configuración de ASP.NET)

Artículo
08/10/2011

Define una nueva opción del compilador. Cualquier número de etiquetas compiler se puede utilizar en la sección compiler.

Nota
En la versión 2.0 de .NET Framework, este elemento ha quedado desusado en favor del elemento compiler de la sección system.codeDom.No obstante, se puede seguir usando el elemento secundario compilers del elemento compilation, lo que reemplaza el elemento compilers ubicado en la sección system.codedom.

<compiler 
   language="language"
   extension="ext"
   type=".NET Type" 
   warningLevel="number"  
   compilerOptions="options"
/>

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
compilerOptions	Atributo opcional. Muestra las opciones específicas del compilador adicionales que se van a pasar durante la compilación.
extension	Atributo opcional. Proporciona una lista separada por punto y coma de extensiones de nombre de archivo que se utilizan para los archivos de código subyacente dinámicos. Por ejemplo, ".cs".
language	Atributo opcional. Proporciona una lista de lenguajes separados por punto y coma que se utilizan en los archivos de compilación dinámicos. Por ejemplo, "c#;cs;csharp".
type	Atributo necesario. Especifica una combinación de clase y ensamblado separada por comas que indica la clase de .NET Framework (que amplía la clase CodeDomProvider) utilizada para compilar todos los recursos que usan el lenguaje o la extensión de nombre de archivo que se ha especificado.
warningLevel	Atributo opcional. Especifica los niveles de advertencia del compilador.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.
system.web	Especifica el elemento raíz de los valores de configuración de ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.
compilation	Configura todas las opciones de compilación que utiliza ASP.NET para compilar aplicaciones.
compilers	Especifica los compiladores compatibles con la aplicación de ASP.NET. Nota En .NET Framework, versión 2.0, este elemento ha quedado desusado en favor del elemento compilers de la sección system.codeDom.Sin embargo, el uso del elemento secundario compilers del elemento compilation sigue siendo válido y reemplaza el elemento compilers que se encuentra en la sección system.codedom.

Comentarios

El elemento compiler define una nueva opción del compilador. Puede usar cualquier número de etiquetas compiler en la sección compiler.

En la versión 2.0 de .NET Framework, este elemento ha quedado desusado en favor del elemento compiler de la sección system.codeDom. No obstante, se puede seguir usando el elemento secundario compilers del elemento compilation, lo que reemplaza el elemento compilers ubicado en la sección system.codedom.

Configuración predeterminada

De manera predeterminada, el elemento compilers no está configurado en la versión 2.0 de .NET Framework porque el elemento ha quedado desusado. Sin embargo, hay un elemento compilers predeterminado definido en la sección system.codeDom.

Este elemento no se configura explícitamente en el archivo Machine.config ni en el archivo Web.config raíz. Sin embargo, es la configuración predeterminada que devuelve la aplicación.

<system.codedom>
   <compilers>
       <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%ECMA_PUBLICKEY%" warningLevel="1" />
       <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%ECMA_PUBLICKEY%" />
       <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=8.0.1100.0, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%" />
       <compiler language="vj#;vjs;vjsharp" extension=".jsl" type="Microsoft.VJSharp.VJSharpCodeProvider, VJSharpCodeProvider, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%" />
       <compiler language="c++;mc;cpp" extension=".h" type="Microsoft.VisualC.CppCodeProvider, CppCodeProvider, Version=8.0.0.0, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%" />
   </compilers>
</system.codedom>

En la versión 1,1 de .NET Framework, el siguiente elemento compilers predeterminado se configura en el archivo Machine.config.

<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>

En la versión 1.0 de .NET Framework, el siguiente elemento compilers predeterminado se configura en el archivo Machine.config.

<compilers>
    <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" warningLevel="1" />
    <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=7.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</compilers>

Ejemplo

En el siguiente ejemplo de código se muestra cómo configurar las opciones de compilación de una aplicación.

<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>
      </compilation>
   </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración	CompilationSection
Miembro de configuración	Compilers Compiler
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorio virtual o físico
Requisitos	Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework versión 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Compartir a través de

Elemento compiler aplicado a compilers para compilation (Esquema de configuración de ASP.NET)

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales