Как .NET читает настройки из app.config под капотом: разбор для пытливых

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="ApiUrl" value="https://api.example.com"/>
    <add key="TimeoutSeconds" value="30"/>
  </appSettings>
  <connectionStrings>
    <add name="MainDb" connectionString="Server=.;Database=MyDb;Trusted_Connection=true;"/>
  </connectionStrings>
</configuration>

Этот XML-файл — не просто набор строк. Это строго типизированная структура, которую .NET интерпретирует особым образом. И вот тут начинается самое интересное.

2. Как работает ConfigurationManager: от вызова до результата

Когда вы вызываете ConfigurationManager.AppSettings["ApiUrl"], происходит следующая цепочка событий:

1. Определение файла конфигурации. Система определяет, какой именно файл читать. Для приложения это YourApp.exe.config (лежащий рядом с exe), для веб-приложения — web.config в корне. Если файла нет — возвращается пустая коллекция.
2. Загрузка XML. Файл читается как XML-документ. Используется System.Xml.XmlDocument или более эффективный XmlReader (зависит от версии .NET).
3. Поиск секции. Ищется элемент <configuration>, затем внутри него — <appSettings>.
4. Парсинг значений. Каждый дочерний элемент <add> с атрибутами key и value преобразуется в пару ключ-значение и помещается в NameValueCollection.
5. Кэширование. Результат кэшируется. Повторный вызов ConfigurationManager.AppSettings не перечитывает файл — он берёт данные из кэша.

Важный нюанс: кэширование и изменения

Если вы измените app.config во время работы приложения, ConfigurationManager.AppSettings не увидит этих изменений, пока не будет перезагружен домен приложения. Это одна из самых частых причин багов: «Я поменял настройки, а программа всё равно использует старые!».

Чтобы принудительно перечитать конфигурацию, можно использовать ConfigurationManager.RefreshSection("appSettings"), но это скорее костыль, чем решение.

3. Секционные обработчики: кастомные секции

Вы, наверное, замечали, что в web.config есть не только appSettings, но и system.web, system.net и другие. Каждая такая секция обрабатывается своим секционным обработчиком — классом, реализующим интерфейс IConfigurationSectionHandler или наследующим ConfigurationSection.

Когда вы пишете свою кастомную секцию, вы по сути создаёте свой собственный парсер. Например:

public class MyCustomSection : ConfigurationSection
{
    [ConfigurationProperty("apiKey", IsRequired = true)]
    public string ApiKey => (string)this["apiKey"];

    [ConfigurationProperty("retryCount", DefaultValue = 3)]
    public int RetryCount => (int)this["retryCount"];
}

А в конфигурации регистрируете:

<configSections>
  <section name="myCustomSection" type="MyNamespace.MyCustomSection, MyAssembly"/>
</configSections>
<myCustomSection apiKey="12345" retryCount="5"/>

Теперь, когда вы вызываете ConfigurationManager.GetSection("myCustomSection"), .NET создаёт экземпляр вашего класса и заполняет его свойства из XML. Это мощный механизм, который позволяет строго типизировать конфигурацию.

4. Под капотом: как парсится XML

Давайте заглянем ещё глубже. Когда вы пишете ConfigurationManager.GetSection("appSettings"), внутри вызывается метод GetSection(string sectionName) из класса System.Configuration.ConfigurationManager. Этот метод:

• Проверяет, не закэширована ли уже секция.
• Если нет — открывает файл конфигурации с помощью System.Configuration.Internal.InternalConfigConfigurationFactory.
• Парсит XML с помощью XmlReader, который читает файл построчно, без загрузки всего документа в память (эффективно для больших конфигов).
• Для каждого элемента <add> создаёт KeyValueConfigurationElement и добавляет его в коллекцию.

Интересный факт: если в файле конфигурации есть ошибка XML (например, незакрытый тег), .NET не выбросит исключение сразу. Он попытается прочитать то, что может, и только при обращении к повреждённой секции вы получите ConfigurationErrorsException. Это поведение часто сбивает с толку разработчиков.

5. Практический пример: читаем настройки правильно

Давайте напишем небольшой класс-помощник, который не только читает настройки, но и обрабатывает ошибки, а также умеет перечитывать конфигурацию при необходимости:

public static class ConfigHelper
{
    public static string GetAppSetting(string key)
    {
        try
        {
            string value = ConfigurationManager.AppSettings[key];
            if (value == null)
            {
                throw new KeyNotFoundException($"Настройка '{key}' не найдена в appSettings.");
            }
            return value;
        }
        catch (ConfigurationErrorsException ex)
        {
            // Логируем ошибку парсинга конфигурации
            Console.WriteLine($"Ошибка конфигурации: {ex.Message}");
            throw;
        }
    }

    public static void ReloadSection(string sectionName)
    {