Элемент compiler для элемента compilers для элемента compilation (схема параметров ASP.NET)

  • Статья

Определяет новый параметр компилятора. В разделе compiler можно использовать любое количество тегов compiler.

ПримечаниеПримечание

В .NET Framework версии 2.0 этот элемент считается устаревшим. Вместо него следует использовать элемент compiler раздела system.codeDom.Однако использование дочернего элемента compilers элемента compilation допускается и переопределяет элемент compilers в разделе system.codedom.

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут

Описание

compilerOptions

Необязательный атрибут.

Перечисляет дополнительные специфичные для компилятора параметры для передачи во время компиляции.

extension

Необязательный атрибут.

Предоставляет список разделенных точкой с запятой расширений имен файлов, используемых для динамических файлов с выделенным кодом. Например, ".cs".

language

Необязательный атрибут.

Предоставляет список разделенных точкой с запятой языков, используемых в файлах динамической компиляции. Например, "c#;cs;csharp".

type

Обязательный атрибут.

Задает разделяемое запятыми сочетание "класс-сборка", указывающее на класс .NET Framework (расширяющий класс CodeDomProvider), необходимый для компиляции всех ресурсов, использующих указанный язык или расширение имени файла.

warningLevel

Необязательный атрибут.

Указывает уровни предупреждений компилятора.

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент

Описание

configuration

Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.

system.web

Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой.

compilation

Настраивает все параметры, используемые в ASP.NET для компиляции приложений.

compilers

Задает компиляторы, которые поддерживаются приложением ASP.NET.

ПримечаниеПримечание
В .NET Framework версии 2.0 этот элемент считается устаревшим. Вместо него следует использовать элемент compilers раздела system.codeDom.Однако использование дочернего элемента compilers элемента compilation допускается и переопределяет элемент compilers в разделе system.codedom.

Заметки

Элемент compiler определяет новый параметр компилятора. В разделе compiler можно использовать любое количество тегов compiler.

В .NET Framework версии 2.0 этот элемент считается устаревшим. Вместо него следует использовать элемент compiler раздела system.codeDom. Однако использование дочернего элемента compilers элемента compilation допускается и переопределяет элемент compilers в разделе system.codedom.

Конфигурация по умолчанию

По умолчанию элемент compilers не задается в .NET Framework версии 2.0, поскольку он является устаревшим. Однако, существует элемент compilers, который по умолчанию задается в разделе system.codeDom.

Этот элемент не задается явно в файле Machine.config или корневом файле Web.config. Однако приложением возвращается именно конфигурация по умолчанию.

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

Для платформы .NET Framework версии 1.1 следующий элемент по умолчанию compilers задается в файле 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>

Для платформы .NET Framework версии 1.0 следующий элемент по умолчанию compilers задается в файле 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>

Пример

В следующем примере кода демонстрируется настройка параметров компиляции для приложения.

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

Сведения об элементе

Обработчик раздела конфигурации

CompilationSection

Элемент конфигурации

Compilers

Compiler

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 1.0, 1.1 или 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Ссылки

Элемент compilers для элемента compilation (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

Элемент system.web (схема параметров ASP.NET)

System.Configuration

System.Web.Configuration

CompilationSection

Compilers

CompilerCollection

Основные понятия

Общие сведения о компиляции в ASP.NET

Общие сведения о синтаксисе веб-страниц ASP.NET

Иерархия и наследование файла конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-сайта ASP.NET

Файлы конфигурации ASP.NET

Конфигурационный API-интерфейс настройки ASP.NET