WebConfigurationManager.OpenMachineConfiguration Method (String)

 

Opens the machine-configuration file on the current computer as a Configuration object to allow read or write operations.

Namespace:   System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

Public Shared Function OpenMachineConfiguration (
	locationSubPath As String
) As Configuration

Parameters

locationSubPath
Type: System.String

The application path to which the machine configuration applies.

Exception Condition
ConfigurationErrorsException

A valid configuration file could not be loaded.

This method opens the machine-configuration file that is applicable to the directory specified by the locationSubPath parameter.

The following example shows how to access configuration information with the OpenMachineConfiguration method.

' Show how to use OpenMachineConfiguration(string).
' It gets the machine.config file applicabe to the
' specified resource and displays section 
' basic information. 
Shared Sub OpenMachineConfiguration2()
    ' Get the machine.config file applicabe to the
    ' specified reosurce.
    Dim config As System.Configuration.Configuration = _
    WebConfigurationManager.OpenMachineConfiguration( _
    "configTest")

    ' Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition")
    Dim i As Integer = 0
    Dim section As ConfigurationSection
    For Each section In config.Sections
        Console.WriteLine((section.SectionInformation.Name + _
        ControlChars.Tab + _
        section.SectionInformation.AllowExeDefinition.ToString()))
        i += 1
    Next section
    Console.WriteLine("[Total number of sections: {0}]", i)

    ' Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath)
End Sub 'OpenMachineConfiguration2


.NET Framework
Available since 2.0
Return to top
Show: