Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

Parameters

sectionName
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()
    Try

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