<providerOption> 元素

指定语言提供程序的编译器版本属性。

<配置>
   <system.codedom>
     <编译 器>
       <编译器>
         <providerOption>

Syntax

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

特性和元素

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

特性

Attribute Description
name 必需属性。

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

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

子元素

没有。

父元素

元素 Description
<配置> 元素 公共语言运行时和 .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属性指定“CompilerVersion”,并为该属性指定“v3.5”。value 必须在版本号前面加上小写“v”。

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

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

Example

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

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

另请参阅