指定語言提供者的編譯器設定屬性。
<組態>
<System.codedom>
<編譯器>
<編譯器>
語法
<compiler
language="languageName[;...;...]"
extension="fileExtension[;...;...]"
type="typeName, assemblyName"
warningLevel="number"
compilerOptions="option1 option2"
/>
屬性和項目
下列章節說明屬性、子元素和父元素。
Attributes
| Attribute | Description |
|---|---|
compilerOptions |
選擇性屬性。 指定額外的編譯器專用參數。 屬性的 compilerOptions 值通常會列在編譯器的選項主題中。 |
extension |
必要屬性。 提供以分號分隔的原始碼檔案副檔名清單,供語言提供者使用。 例如,「.cs」。 |
language |
必要屬性。 提供語言提供者支援的分號分隔語言名稱清單。 例如,「c#;電腦科學;Csharp」。 |
type |
必要屬性。 指定語言提供者的型別名稱,包括包含提供者實作的組合名稱。 型別名稱必須符合 《指定完全合格型別名稱》中所定義的要求。 |
warningLevel |
選擇性屬性。 指定預設的編譯器警告等級;決定語言提供者將編譯警告視為錯誤的層級。 |
子元素
| 元素 | Description |
|---|---|
| <providerOption> Element | 指定語言提供者的編譯器版本屬性。 |
父項目
| 元素 | Description |
|---|---|
| < | 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
| <system.codedom> 元素 | 指定可用語言提供者的編譯器設定。 |
| <編譯器> Element | 編譯器配置元件容器;包含零個或多個 <compiler> 元素。 |
備註
每個 <compiler> 元素都指定特定語言提供者的編譯器設定屬性。 提供者擴展 System.CodeDom.Compiler.CodeDomProvider 了特定語言的類別;元素 <compiler> 定義了語言提供者的編譯器與程式碼產生器的設定。
.NET Framework 在機器設定檔(Machine.config)中定義初始編譯器的設定。 開發者與編譯器廠商可以為新 CodeDomProvider 實作新增設定。 使用此 CodeDomProvider.GetAllCompilerInfo 方法可程式化地列舉電腦上的語言提供者與編譯器設定。
應用程式或網頁設定檔中的編譯器元素可以補充或覆寫機器設定檔中的設定。 若多個提供者實作被設定為相同語言名稱或相同檔案副檔名,最後匹配的設定會覆蓋該語言名稱或檔案副檔名之前所有配置的提供者。
組態檔
此元素可用於機器設定檔及應用程式設定檔中。
Example
以下範例說明了典型的編譯器配置元素:
<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>