Configuration Sections-Create a customized section using ConfigurationSection class: Part II

Introduction:

This article extends the custom configuration section concept introduction. Therefore, it is strongly advised to read the previous article witch is "Part I: Introducing the custom configuration section concept" for well understanding purposes.

Suppose that the "Application F" is used by the financial department and the "Application A" is by the Account department as a part of the enterprise resource planning ERP. The first one listens to the second one. The listening procedure is done periodically for update operations purposes. Suddenly, the information system department decides to make some changes concerning the access privilege via some ports for a security issues, so that it will be not possible that F can listen to A. In this case, you have to rectify the port values from the F code source for each time the situation of access via this port is going to be changed. The second alternative is to convince the information department does not change the port access privilege so that F can listen to A without any interruptions. It is not practical at all to adopt such alternatives. In order to avoid this trouble, we can create a custom section in the application configuration file that enables us change parameters according to a given port at any time. There is two ways to do that. The first way is to define a custom section by extending it from the ConfigurationSection class witch is an abstract class and that means that it is not possible to define a direct instantiated object from it, in other means, it must be inherited. The second way is to use the IConfigurationSection interface witch is out of the scope of this part and witch constitutes the subject of a subsequent article.

Imagine that there is a partially centralized information system designed as follow:



This is a quick representation of the ConfigurationSection class witch constitute our section class handler:*

The class



The members



Step by step I will show how to deal:

• Add a class to your project and name it PortsSectionHandler. Click Ok. Remember that each section element needs a section handler class to be set.
• Replace class by namespace as shown bellow

• Create a new section handler class by extending it from the Configuration section class. We assume that there are not other sub elements that should be added.
• We consider that a port section has some attributes witch are:
  
  Key
  Serial
  
  
• Add a new class within the namespace PortsSectionHandler and name it PortsSectionHandler
  
  public class PortSectionHandler : ConfigurationSection

  {}

As shown, this class inherits from Configuration section abstract class. The next step consists on adding two constructors and three properties to this above class.

public class PortSectionHandler : ConfigurationSection

{

//First constructor

public PortSectionHandler() { }

//Second constructor

public PortSectionHandler(string SectionName,string Key, string Serial)

{

this.SectionName = SectionName; this.Key = Key; this.Serial = Serial;

}

//First property: SectionName

private string _SectionName;

public string SectionName

{
get
{
return _SectionName;
}
set
{
_SectionName = value;
}
}

//Second property: The port Key

[ConfigurationProperty("key", DefaultValue = "Account", IsRequired = true)]

[StringValidator(InvalidCharacters = "|~!@#$%^&*()[]{}/;'\\",MinLength = 1)]

public string Key

{
get
{
return (string)this["key"];
}

set
{
this["key"] = value;
}
}

//Third property: The port serial

[ConfigurationProperty("serial", DefaultValue = "9000",IsRequired = true)]

[StringValidator(InvalidCharacters = "|~!@#$%^&*()[]{}/;'\\", MinLength = 1)]

public string Serial

{
get
{
return this["serial"] as string;
}
set
{
this["serial"] = value;
}
}
}