Click here to Skip to main content
13,798,492 members
Click here to Skip to main content
Add your own
alternative version

Tagged as

Stats

5.9K views
109 downloads
9 bookmarked
Posted 14 Jan 2018
Licenced CPOL

App.Config Autoreader

Rate this:
Please Sign up or sign in to vote.
Automatic read and convert data of App.Config settings keys.

Introduction

In our day to day, in our developments, it is a rare case when we don’t need to read a configuration file. 
There are many techniques for its treatment such as a static class, a singleton class, etc. It is also normal to make this config class to be accessible throughout the project.

We will write a utility to automate the task of reading an app.config file. With this utility you will forget about using the ConfigurationManager class and the System.Configuration assembly.

We will make use of dynamics.

App.Config Autoreader is an Open Source project and it is available in inside of MoralesLarios.Development project in GitHub in this Link.

 

Index

  1. Autoreader description
  2. Install and use
  3. Pros and Cons
  4. Autoreader Transforms Types
    • Strings values
    • Numerics values
    • Date and DateTime values
    • Bools values
    • Arrays values
  5. Force values to string
  6. Save special character

 

 

Autoreader description

The autoreader action consists of app.config file read in the first step, convert values action for second step and final step, creation result class.

Simple example of a string value.

 

The process transforms the string key value to a strong type target variable.

The Config class, is responsible for expose the transformed app.config values.  

The Config class expose the app.Config values with strong types, but in a dynamic property.

 

Install and use

1.- For use, we download a nuget package MoralesLarios.Development.

Install-Package MoralesLarios.Development

 

2.- Add one setting in an app.config file.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2" />
    </startup>

  <appSettings>
    <add key="FilterDate" value="01/01/2018"/>
  </appSettings>

</configuration>

 

3.- Add using in the consumer class.

using MoralesLarios.Development.Configuration;

 

4.- Create a new variable of our app.config settings key and call Config.ConfigNodes.[app.config_keyName].

static void Main(string[] args)
{
    DateTime filterDate = Config.ConfigNodes.FilterDate;
}

 

All code.

using MoralesLarios.Development.Configuration;
using System;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            DateTime filterDate = Config.ConfigNodes.FilterDate;
        }
    }
}

 

The execution read a DateTime value.

 

 

 

Prons and Cons

These are the pros and cons of Autoreader App.Config utility:

PROS.

  • Faster reader
  • Faster transform
  • Simple use and compression
  • Add a new key in app.config and it is available in this time.

CONS.

  • The app values are exposed in dynamics values, so that we lost the intellisense.

 

 

Autoreader Transforms Types

Autoreader utility can transform values of same types:

  • Stirngs
  • Numerics
  • Dates and DateTimes
  • Bools
  • Array of
    • Strings Arrays
    • Numerics Arrays
    • DateTimes Arrays
    • Bools Arrays

We will explain in deep each one of them.

 

 

Strings values

Is the very single process and transform the string app.config key value to string variable destination.

 

Numerics values

The process for numerics values is very similar to string values. In this action the string app.config key value is transformed to decimal value.

We decided choose a decimal type for numerics values for include all numerics types (short, int, double, etc).

 

Date and DateTime values

In this action the string app.config key value is transformed to datetime value.

DATE

DATETIME

 

Bools values

In this action the string app.config key value is transformed to bool value.

 

Arrays values

The array process is the same of the another’s types, but with the deference the app.config key value should contain an internal ‘;’ value, for delimiting some array nodes.

 This rule is valid for all arrays types.

Its result:

 

 

Force values to string

In cases we can may need read app.config key values of types (numerics, datetimes, bools, etc) as a strings values. In these cases, we can use (‘’) for force a string read value.

Variable value.

 

 

Save special character

If we want read a app.config key with special character as ( ; or ‘’), we can preceded the ‘\’ backslash the special character.

Example:

 

 

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Juan Francisco Morales Larios
Software Developer (Senior) Cecabank
Spain Spain
MVP C# Corner 2017

MAP Microsoft Active Professional 2014

MCPD - Designing and Developing Windows Applications .NET Framework 4
MCTS - Windows Applications Development .NET Framework 4
MCTS - Accessing Data Development .NET Framework 4
MCTS - WCF Development .NET Framework 4

You may also be interested in...

Comments and Discussions

 
QuestionMy vote of #2 Pin
BillWoodruff16-Jan-18 14:14
mentorBillWoodruff16-Jan-18 14:14 
AnswerRe: My vote of #2 Pin
Juan Francisco Morales Larios16-Jan-18 15:39
memberJuan Francisco Morales Larios16-Jan-18 15:39 
GeneralRe: My vote of #2 Pin
BillWoodruff18-Jan-18 17:38
mentorBillWoodruff18-Jan-18 17:38 
GeneralRe: My vote of #2 Pin
Juan Francisco Morales Larios19-Jan-18 3:23
memberJuan Francisco Morales Larios19-Jan-18 3:23 
Questionwhat is the license of your GitHub project? Pin
Southmountain15-Jan-18 12:03
memberSouthmountain15-Jan-18 12:03 
AnswerRe: what is the license of your GitHub project? Pin
Juan Francisco Morales Larios15-Jan-18 22:08
memberJuan Francisco Morales Larios15-Jan-18 22:08 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web01 | 2.8.181207.3 | Last Updated 14 Jan 2018
Article Copyright 2018 by Juan Francisco Morales Larios
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid