‫مدیریت هوشمند تنظیمات در NET 11.: آشنایی با ConfigurationIgnoreAttribute

public class CsvIngestionOptions
{
    // این ویژگی حاصل پردازش ثانویه است و نباید مستقیماً از فایل تنظیمات خوانده شود
    public CsvFormatOptions DefaultFormat { get; set; }

    // بخش خامی که از فایل تنظیمات خوانده شده و خودمان آن را پردازش می‌کنیم
    public IConfigurationSection? DefaultFormatSection { get; set; }

    internal void OnConfigurationLoaded()
    {
        DefaultFormat = new CsvFormatOptions();
        DefaultFormatSection?.Bind(DefaultFormat);
        DefaultFormat.EnsureEncodingDefined();
    }
}

// یک راهکار غیر استاندارد و آسیب‌پذیر
[ConfigurationKeyName("__ignored_" + nameof(DefaultFormat))]
public CsvFormatOptions DefaultFormat { get; set; }

namespace Microsoft.Extensions.Configuration;

[AttributeUsage(AttributeTargets.Property)]
public sealed class ConfigurationIgnoreAttribute : Attribute { }

using Microsoft.Extensions.Configuration;

public class CsvIngestionOptions
{
    [ConfigurationIgnore]
    public CsvFormatOptions DefaultFormat { get; set; }

    [ConfigurationKeyName(nameof(DefaultFormat))]
    public IConfigurationSection? DefaultFormatSection { get; set; }

    internal void OnConfigurationLoaded()
    {
        DefaultFormat = new CsvFormatOptions();
        DefaultFormatSection?.Bind(DefaultFormat);
        DefaultFormat.EnsureEncodingDefined();
    }
}

public class FeatureFlags
{
    // مقداری که مستقیماً از appsettings.json خوانده می‌شود
    public string RawFlags { get; set; } = string.Empty;

    // خروجی پردازش شده که باید از دید فرآیند Binding پنهان بماند
    [ConfigurationIgnore]
    public IReadOnlyDictionary<string, bool> ParsedFlags { get; set; } 
        = new Dictionary<string, bool>();
}

نکته کلیدی علمی: سیستم پیکربندی NET (Microsoft.Extensions.Configuration). یک لایه انتزاعی (Abstraction) مستقل است و از هسته سریال‌سازی JSON مجزا عمل می‌کند. این سیستم داده‌ها را از منابع مختلفی مانند کدهای دستوری (CLI Arguments)، متغیرهای محیطی (Environment Variables)، دیتابیس‌ها و فایل‌های XML/JSON جمع‌آوری کرده و به یک ساختار کلید-مقدار (Key-Value) تخت تبدیل می‌کند. بنابراین، Binder داخلی تنظیمات هیچ شناختی از اتریبیوت‌های اختصاصی System.Text.Json یا Newtonsoft.Json ندارد و آن‌ها را کاملاً نادیده می‌گیرد.