<providerOption> Element
Specifies the compiler version attributes for a language provider.
<configuration>
<system.codedom>
<compilers>
<compiler>
<providerOption>
Syntax
<providerOption
name="option-name"
value="option-value"
/>
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
| Attribute | Description |
|---|---|
name |
Required attribute. Specifies the name of the option; for example, "CompilerVersion". |
value |
Required attribute. Specifies the value for the option; for example, "v3.5". |
Child Elements
None.
Parent Elements
| Element | Description |
|---|---|
| <configuration> Element | The root element in every configuration file that is used by the common language runtime and .NET Framework applications. |
| <system.codedom> Element | Specifies compiler configuration settings for available language providers. |
| <compilers> Element | Container for compiler configuration elements; contains zero or more <compiler> elements. |
| <compiler> Element | Specifies the compiler configuration attributes for a language provider. |
Remarks
In .NET Framework version 3.5, Code Document Object Model (CodeDOM) code providers can support provider-specific options by using the <providerOption> element.
The .NET Framework 3.5 includes updated .NET Framework 2.0 assemblies and provides new version 3.5 assemblies that contain new types. The Microsoft C# and Visual Basic code providers are contained in .NET Framework 2.0 assemblies but have been updated to support version 3.5 compilers. By default, the updated code providers generate code for version 2.0 compilers. You can use the <providerOption> element to change the target compiler version to 3.5. To do this, specify "CompilerVersion" for the name attribute and "v3.5" for the value attribute. You must precede the version number with a lower-case "v".
You can make the version specification global by adding the <providerOption> element to the .NET Framework 2.0 Machine.config or root Web.config file. If you update the default compiler version to 3.5 in the Machine.config file, you can change it back to 2.0 on a per-application basis by using the <providerOption> element in the application configuration file.
CodeDOM code provider implementers can process custom options by providing a constructor that takes a providerOptions parameter of type IDictionary<TKey,TValue>.
Example
The following example demonstrates how to specify that version 3.5 of the C# code provider should be used.
<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>
