This documentation is archived and is not being maintained.

VBCodeProvider Constructor (IDictionary<String, String>)

Initializes a new instance of the VBCodeProvider class by using the specified provider options.

Namespace:  Microsoft.VisualBasic
Assembly:  System (in System.dll)

public VBCodeProvider(
	IDictionary<string, string> providerOptions


Type: System.Collections.Generic.IDictionary<String, String>
A IDictionary<TKey, TValue> object that contains the provider options from the configuration file.


providerOptions is null.

The value for providerOptions is obtained from the <providerOption> element in the configuration file. You can identify the version of the VBCodeProvider you want to use by specifying the <providerOption> element, supplying "CompilerVersion" as the option name, and supplying the version number (for example, "v3.5") as the option value. You must precede the version number with a lower case "v".

The following configuration file example demonstrates how to specify that version 3.5 of the Visual Basic code provider should be used.

      <!-- zero or more compiler elements -->
          type="Microsoft.VisualBasic.VBCodeProvider, System, 
          Version=2.0.3600.0, Culture=neutral, 
          warningLevel="1" >
            value="v3.5" />

The following example shows how to specify the compiler version when creating a new instance of the VBCodeProvider class.

Imports System
Imports System.CodeDom.Compiler
Imports Microsoft.CSharp
Imports Microsoft.VisualBasic
Imports System.Collections.Generic

Class Program

    Shared Sub Main(ByVal args() As String)
        Console.WriteLine("Press Enter key to exit.")

    End Sub 'Main

    Shared Sub DisplayVBCompilerInfo()
        Dim provOptions As New Dictionary(Of String, String)
        provOptions.Add("CompilerVersion", "v3.5")
        ' Get the provider for Microsoft.VisualBasic
        Dim vbProvider As VBCodeProvider = New VBCodeProvider(provOptions)

        ' Display the Visual Basic language provider information.
        Console.WriteLine("Visual Basic provider is {0}", vbProvider.ToString())
        Console.WriteLine("  Provider hash code:     {0}", vbProvider.GetHashCode().ToString())
        Console.WriteLine("  Default file extension: {0}", vbProvider.FileExtension)


    End Sub 'DisplayVBCompilerInfo
End Class 'Program

.NET Framework

Supported in: 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

  • LinkDemand 

    for full trust for the immediate caller. This member cannot be used by partially trusted code.

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.