Elemento <compiler>
Actualización: noviembre 2007
Especifica los atributos de configuración del compilador para un proveedor de lenguaje.
<configuration> (Elemento)
<system.codedom> (Elemento)
Elemento <compilers>
Elemento <compiler>
<compiler
language="languageName[;...;...]"
extension="fileExtension[;...;...]"
type="typeName, assemblyName"
warningLevel="number"
compilerOptions="option1 option2"
/>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
Atributo |
Descripción |
|---|---|
compilerOptions |
Atributo opcional. Especifica los argumentos específicos del compilador adicionales para la compilación. Normalmente, los valores del atributo compilerOptions aparecen en una lista en un tema de opciones del compilador. En la documentación de Visual Studio 2005, puede encontrar las opciones del compilador buscando "opciones del compilador" en el índice. |
extension |
Atributo requerido. Proporciona una lista separada por punto y coma con las extensiones de nombre de archivo utilizadas por los archivos de código fuente del proveedor de lenguaje. Por ejemplo, ".cs". |
language |
Atributo requerido. Proporciona una lista separada por punto y coma con los nombres de lenguaje admitidos por el proveedor de lenguaje. Por ejemplo, "c#;cs;csharp". |
type |
Atributo requerido. Especifica el nombre de tipo completo del proveedor de lenguaje, así como el nombre del ensamblado que contiene la implementación de proveedores. El nombre de tipo debe cumplir los requisitos definidos en Especificar nombres de tipo completos. |
warningLevel |
Atributo opcional. Especifica el nivel de advertencia del compilador predeterminado; determina el nivel a partir del cual el proveedor de lenguaje trata las advertencias de compilación como errores. |
Elementos secundarios
Ninguna.
Elementos primarios
Elemento |
Descripción |
|---|---|
Elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework. |
|
Especifica las opciones de configuración del compilador para los proveedores de lenguaje disponibles. |
|
Contenedor de elementos de configuración del compilador; contiene el cero o más elementos <compiler>. |
Comentarios
Cada elemento <compiler> especifica los atributos de configuración de compilador para un proveedor de lenguaje específico. El proveedor extiende la clase System.CodeDom.Compiler.CodeDomProvider para un lenguaje concreto; el elemento <compiler> define la configuración del compilador y del generador de código para el proveedor de lenguaje.
.NET Framework define la configuración inicial del compilador en el archivo de configuración del equipo (Machine.config). Los desarrolladores y los proveedores de compiladores pueden agregar opciones de configuración a una nueva implementación de CodeDomProvider. Utilice el método CodeDomProvider.GetAllCompilerInfo para enumerar mediante programación los proveedores de lenguaje y las opciones de configuración del compilador en un equipo.
Los elementos de compilador de la aplicación o del archivo de configuración de Web pueden complementar o reemplazar la configuración del archivo de configuración del equipo. Si se configura más de una implementación de proveedor para el mismo nombre de lenguaje o la misma extensión de archivo, la última configuración que coincida con estos reemplazará cualquier proveedor configurado anteriormente para ese nombre de lenguaje o esa extensión de archivo.
Archivo de configuración
Este elemento se puede utilizar en el archivo de configuración del equipo y en el archivo de configuración de la aplicación.
Ejemplo
El ejemplo siguiente ilustra un elemento de configuración de compilador típico.
<configuration>
<system.codedom>
<compilers>
<!-- zero or more compiler elements -->
<compiler
language="c#;cs;csharp"
extension=".cs"
type="Microsoft.CSharp.CSharpCodeProvider, System,
Version=2.0.3600.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089"
compilerOptions="/optimize"
warningLevel="1" />
</compilers>
</system.codedom>
</configuration>
Vea también
Conceptos
Especificar nombres de tipo completos
Referencia
Elemento compiler aplicado a compilers para compilation (Esquema de configuración de ASP.NET)