<compiler> 項目

發行項
08/12/2011

指定語言提供者的編譯器組態屬性。

<compiler
  language="languageName[;...;...]"
  extension="fileExtension[;...;...]"
  type="typeName, assemblyName"
  warningLevel="number"
  compilerOptions="option1 option2"
/>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

屬性	描述
compilerOptions	選擇性屬性。指定編譯的其他特定編譯器引數。 compilerOptions 屬性的值，通常會列在編譯器的編譯器選項的主題中。在 Visual Studio 2005 文件中，您可以在索引中搜尋 "compiler options"，以找出編譯器。
extension	必要屬性。為語言提供者提供原始程式檔使用的檔案副檔名清單 (以分號分隔)。例如，".cs"。
language	必要屬性。提供語言提供者支援之語言名稱的以分號分隔清單。例如，"c#;cs;csharp"。
type	必要屬性。指定語言提供者的型別名稱，包括含有提供者實作的組件名稱。型別名稱必須符合指定完整型別名稱中定義的要求。
warningLevel	選擇性屬性。指定預設編緝器警告層級，判斷語言提供者將編譯警告視為錯誤的層級。

子項目

項目	描述
<providerOption> 項目	指定語言提供者的編譯器版本屬性。

父項目

項目	描述
<configuration> 項目	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
<system.codedom> 項目	指定可用語言提供者的編譯器組態設定。
<compilers> 項目	編譯器組態項目的容器；內含零或多個 <compiler> 項目。

備註

每個 <compiler> 項目都會為特定語言提供者指定編譯器組態屬性。提供者會為特定語言擴充 System.CodeDom.Compiler.CodeDomProvider 類別；<compiler> 項目則會為語言提供者定義編譯器和程式碼產生器的設定。

.NET Framework 會在電腦組態檔 (Machine.config) 中定義初始編譯器設定。開發人員和編譯器廠商可以加入新 CodeDomProvider 實作的組態設定。使用 CodeDomProvider.GetAllCompilerInfo 方法，以程式設計方式列舉電腦上的語言提供者和編譯器組態設定。

應用程式或 Web 組態檔中的編譯器項目可補充或覆寫電腦組態檔中的設定。如果為相同的語言名稱或相同的副檔名設定一個以上的提供者實作，最後相符的組態會覆寫任何之前為該語言名稱或副檔名所設定的提供者。

組態檔

這個項目可用於電腦組態檔和應用程式組態檔。

範例

下列範例說明典型的編譯器組態項目。

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

請參閱

<compiler> 項目

屬性和項目

屬性

子項目

父項目

備註

組態檔

範例

請參閱

參考

概念

其他資源

其他資源