Read and modify a configuration

To read and modify configuration, you use Config and ConfigManager.

The ConfigManager class reads configurations from folder ~/App_Data/Sitefinity/Configuration. The configuration section is stored in a file with the same name as the configuration class. The extension is .config. The file is created only if the configuration differs from the default values.

NOTE: To create the file, you can copy and modify an existing configuration file.

• The PageAppearanceConfig.config contains the following code:

  	<?xml version="1.0" encoding="utf-8" ?>
  	<pageAppearanceConfig xmlns:config="urn:telerik:sitefinity:configuration" xmlns:type="urn:telerik:sitefinity:configuration:type" config:version="4.2.1641.0" remoteOnly="False" country="USA">
  	<color background="008000" foreground="D3D3D3"/>
  	<Fonts>
  	<add size="18" name="Verdana" />
  	</Fonts>
  	</pageAppearanceConfig>

  view raw ModifyConfigs_PageAppearanceConfig.config.xml hosted with ❤ by GitHub
• To read values from PageAppearanceConfig.config, use the following code:

  	using Telerik.Sitefinity.Configuration;
  	namespace SitefinityWebApp
  	{
  	public class ReadValuesPageAppearanceConfig
  	{
  	public static void ReadPageAppearanceConfig()
  	{
  	PageAppearanceConfig config = Config.Get<PageAppearanceConfig>();
  	var pageColor = config.Color;
  	var pageFontSize = config.Fonts["Verdana"].Size;
  	}
  	}
  	}

  view raw ReadValuesPageAppearanceConfig.cs hosted with ❤ by GitHub
• To modify values from PageAppearanceConfig.config, use the following code:

  	using Telerik.Sitefinity.Configuration;
  	namespace SitefinityWebApp
  	{
  	public class ModifyValuesPageAppearanceConfig
  	{
  	public static void ReadPageAppearanceConfig()
  	{
  	ConfigManager manager = ConfigManager.GetManager();
  	PageAppearanceConfig config = manager.GetSection<PageAppearanceConfig>();
  	config.Fonts.Add(new FontElement(config.Fonts)
  	{
  	Name = "TimesNewRoman",
  	Size = 16,
  	});
  	manager.SaveSection(config);
  	}
  	}
  	}

  view raw ModifyValuesPageAppearanceConfig.cs hosted with ❤ by GitHub
• To modify nested configurations, for example, LoadBalancingConfig, which is part of SystemConfig.config, use the following code:

  	using Telerik.Sitefinity.Configuration;
  	using Telerik.Sitefinity.LoadBalancing;
  	using Telerik.Sitefinity.LoadBalancing.Configuration;
  	using Telerik.Sitefinity.Services;
  	namespace SitefinityWebApp
  	{
  	public class ModifyNestedConfigs
  	{
  	public void NestedConfigs()
  	{
  	ConfigManager manager = ConfigManager.GetManager();
  	SystemConfig systemConfig = manager.GetSection<SystemConfig>();
  	var loadBalancingConfig = systemConfig.LoadBalancingConfig;
  	loadBalancingConfig.Senders.Add(new TypeNameConfigElement(loadBalancingConfig)
  	{
  	Value = typeof(WebServiceSystemMessageSender).FullName
  	});
  	manager.SaveSection(systemConfig);
  	}
  	}
  	}

  view raw ModifyNestedConfigurations.cs hosted with ❤ by GitHub

NOTE: The PageAppearanceConfig class in the samples above is a custom class. For more information about creating custom configuration classes, see Create a new configuration.