October 2017 : Online course in ASP.NET MVC / Core. Conducted by Bipin Joshi. Read more...
Registration for October 2017 batch of ASP.NET MVC / Core online course has already started. Conducted by Bipin Joshi. Book your seat today ! Click here for more details.

Creating Custom Configuration Sections


ASP.NET allows you to store your own configuration settings in the <appSettings> section of web.config file. This section allows you to store settings as key-value pairs. This works well if you have few key-value pairs. However, if you have many such configuration settings then it becomes bit difficult to categorically store the values. Good part is that ASP.NET allows you to define your own sections to store such settings. In this article we will see how to create your own configuration sections and access them in your code.

Section Handlers

The web.config file consists of several sections and each such section is supposed to be processed by a section handler. A section handler is nothing but a class that implements IConfigurationSectionHandler interface. In this article we will not go into the details of this interface but we will see how to use one built-in section handler. You can specify the section handler for a particular section in the web.config file itself.

Specifying Section Handler

Let's assume that you want to create a custom configuration section like this:

<add key="adminmail" value="administrator@somedomain.com"/>
<add key="salesmail" value="sales@somedomain.com"/>
<add key="supportmail" value="support@somedomain.com"/>
<add key="admail" value="advertising@somedomain.com"/>

Here, we are storing the configuration settings as key-value pairs but they are nested inside other tags.

Now that you know how your section is going to be, let us put markup in web.config that will indicate how this section will be handled. .NET comes with a built-in section handler called NameValueSectionHandler that resides in System.Configuration namespace. This handler is responsible to handle sections that store settings as key-value pairs (such as <appSettings>).  We will be using this section handler for our section.

<sectionGroup name="sitesettings">
<sectionGroup name="common">
<section name="emails" type=

Reading section values in your code

Once you put section handler and sections in your web.config you can access the values in your code as follows:

NameValueCollection nvc = (NameValueCollection)
Label1.Text = nvc["salesmail"];
Label2.Text = nvc["supportmail"];
Label3.Text = nvc["adminmail"];


In this article we saw how to create your custom web.config sections. Web.config sections are handled by classes implementing IConfigurationSectionHandler interface. We used NameValueSectionHandler class that handles <appSettings> section of web.config. In the next article we will see how to create our own class that implements IConfigurationSectionHandler and process our custom sections.




Bipin Joshi is a software consultant, an author and a yoga mentor having 22+ years of experience in software development. He also conducts online courses in ASP.NET MVC / Core and Design Patterns. He is a published author and has authored or co-authored books for Apress and Wrox press. Having embraced the Yoga way of life he also teaches Meditation and Mindfulness to interested individuals. To know more about him click here.

Get connected : Twitter  Facebook  Google+  LinkedIn

Posted On : 13 June 2004

Tags : ASP.NET Components Configuration