Collection of classes to help retrieve settings from App.config files in .NET.
ByteDev.Configuration has been written as a .NET Standard 2.0 library, so you can consume it from a .NET Core or .NET Framework 4.6.1 (or greater) application.
ByteDev.Configuration is hosted as a package on nuget.org. To install from the Package Manager Console in Visual Studio run:
Install-Package ByteDev.Configuration
Further details can be found on the nuget page.
Releases follow semantic versioning.
Full details of the release notes can be viewed on GitHub.
Functionality is in three main areas:
- Config Sections & Settings
- App Settings
- Connection Settings
Example config:
<configSections>
<section name="Health" requirePermission="false" type="System.Configuration.NameValueSectionHandler,System,Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</configSections>
<Health>
<add key="EnableAssessmentOnStart" value="false" />
</Health>
Simple usage:
var sectionProvider = new ConfigSectionProvider();
var settingsProvider = new ConfigSettingsProvider(sectionProvider);
bool value = settingsProvider.GetBool("EnableAssessment", "Health");
Example of wrapping the use of ConfigSettingsProvider in your own config class:
public class MyConfig
{
private readonly IConfigSettingsProvider _provider;
public MyConfig(IConfigSettingsProvider provider)
{
_provider = provider;
}
public bool EnableAssessment
{
get { return _provider.GetBool("EnableAssessment", "Health") }
}
}
This will lead to the following stack:
MyConfig
-> ConfigSettingsProvider
--> ConfigProvider
---> System.Configuration.ConfigurationManager
Example config:
<appSettings>
<add key="ClientRetries" value="5"/>
</appSettings>
Simple usage:
var provider = new AppSettingsProvider();
int value = provider.GetInt("ClientRetries");
Example config:
<connectionStrings>
<add name="MyDb" connectionString="Data Source=.;Initial Catalog=MyDb;Integrated Security=True" />
</connectionStrings>
Simple usage:
var provider = new ConnectionSettingsProvider();
var connSettings = provider.GetConnectionSettings("MyDb");