Configuration.GetSection Method (String)


Returns the specified ConfigurationSection object.

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

Public Function GetSection (
	sectionName As String
) As ConfigurationSection


Type: System.String

The path to the section to be returned.

Return Value

Type: System.Configuration.ConfigurationSection

The specified ConfigurationSection object.

Configuration settings are contained within sections that group similar settings together for convenience. The GetSection method retrieves a configuration section by its name.

The following example shows how to use the GetSection method to access a custom section. For the complete example code that defines a class that stores information for the CustomSection section, see the Configuration class overview.

' Show how to use the GetSection(string) method.
Public Shared Sub GetCustomSection()

        Dim customSection As CustomSection

        ' Get the current configuration file.
        Dim config As System.Configuration.Configuration = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)

        customSection = TryCast(config.GetSection("CustomSection"), CustomSection)

        Console.WriteLine("Section name: {0}", customSection.Name)
        Console.WriteLine("Url: {0}", customSection.Url)
        Console.WriteLine("Port: {0}", customSection.Port)

    Catch err As ConfigurationErrorsException
        Console.WriteLine("Using GetSection(string): {0}", err.ToString())
    End Try

End Sub

.NET Framework
Available since 2.0
Return to top