compilation の compilers の compiler 要素 (ASP.NET 設定スキーマ)

新しいコンパイラ オプションを定義します。 compiler セクションでは、任意の数の compiler タグを使用できます。

メモメモ

.NET Framework Version 2.0 では、この要素の使用は推奨されません。代わりに system.codeDom セクションの compiler 要素を使用します。ただし、compilation 要素の compilers 子要素はまだ有効で、system.codedom セクションにある compilers 要素をオーバーライドします。

<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

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。

system.web

構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。

compilation

ASP.NET でアプリケーションのコンパイルに使用されるすべてのコンパイル設定値を構成します。

compilers

ASP.NET アプリケーションがサポートするコンパイラを指定します。

メモメモ
.NET Framework Version 2.0 では、system.codeDom セクションの compilers 要素のために、この要素の使用を避けるように推奨されています。ただし、compilation 要素の compilers 子要素はまだ有効で、system.codedom セクションにある compilers 要素をオーバーライドします。

解説

compiler 要素は、新しいコンパイラ オプションを定義します。 compiler セクションでは、任意の数の compiler タグを使用できます。

.NET Framework Version 2.0 では、この要素の使用は推奨されません。代わりに system.codeDom セクションの compiler 要素を使用します。 ただし、compilation 要素の compilers 子要素はまだ有効で、system.codedom セクションにある compilers 要素をオーバーライドします。

既定の構成

.NET Framework Version 2.0 では、compilers 要素の使用が推奨されていないため、既定では compilers 要素は構成されません。 ただし、system.codeDom セクションには、既定の compilers 要素が定義されています。

この要素は、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>

次の既定の compilers 要素は、.NET Framework Version 1.1 の 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>

次の既定の compilers 要素は、.NET Framework Version 1.0 の 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 Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0

.NET Framework Version 1.0、1.1、または 2.0

Microsoft Visual Studio 2003 または Visual Studio 2005

参照

処理手順

方法 : Location の設定を使用して特定のディレクトリを構成する

方法 : ASP.NET 構成設定をロックする

参照

compilation の compilers 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

system.web 要素 (ASP.NET 設定スキーマ)

System.Configuration

System.Web.Configuration

CompilationSection

Compilers

CompilerCollection

概念

ASP.NET コンパイルの概要

ASP.NET Web ページの構文の概要

ASP.NET 構成ファイルの階層と継承

ASP.NET 構成の保護

ASP.NET の構成のシナリオ

その他の技術情報

全般構成設定 (ASP.NET)

ASP.NET 構成設定

ASP.NET Web サイト管理

ASP.NET 構成ファイル

ASP.NET 構成 API