<providerOption> 元素

指定语言提供程序的编译器配置属性。

<configuration>
  <system.codedom>
    <compilers>
      <compiler>
        <providerOption>

语法

<providerOption  
  name="option-name"  
  value="option-value"  
/>  

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 描述
name 必需的特性。

指定选项的名称;例如 “CompilerVersion”。
value 必需的特性。

指定选项的值;例如“v3.5”。

子元素

无。

父元素

元素 说明
<configuration> 元素 公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
<system.codedom> 元素 指定可用语言提供程序的编译器配置设置。
<compilers> 元素 编译器配置元素的容器;包含零个或多个 <compiler> 元素。
<compiler> 元素 指定语言提供程序的编译器配置属性。

注解

在 .NET Framework 3.5 中,代码文档对象模型 (CodeDOM) 代码提供程序可以使用 <providerOption> 元素支持特定于提供程序的选项。

.NET Framework 3.5 包括更新的 .NET Framework 2.0 程序集,并提供包含新类型的 3.5 版本的新程序集。 Microsoft C# 和 Visual Basic 代码提供程序包含在 .NET Framework 2.0 程序集中,但已更新为支持 3.5 版本的编译器。 更新的代码提供程序默认为 2.0 版本编译器生成代码。 可以使用 <providerOption> 元素将目标编译器版本更改为 3.5 版本。 为此,请将属性指定为 name,并将 value 属性指定“v3.5”。 必须在版本号前面加上小写“v”。

可以通过将 <providerOption> 元素添加到 .NET Framework 2.0 Machine.config 或根 Web.config 文件来使版本规范成为全局版本。 如果将 Machine.config 文件中的默认编译器版本更新为 3.5,则可以通过使用应用程序配置文件中的 <providerOption> 元素,将每个应用程序的编译器版本更改回 2.0。

CodeDOM 代码提供程序实现器可以通过提供采用 providerOptions 类型 IDictionary<TKey,TValue> 参数的构造函数来处理自定义选项。

示例

下面的示例演示如何指定应使用 3.5 版 C# 代码提供程序。

<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" >  
          <providerOption  
            name="CompilerVersion"  
            value="v3.5" />  
      </compiler>  
    </compilers>  
  </system.codedom>  
</configuration>  

请参阅