‫واژه‌ی کلیدی field در C# 14 می‌تواند باعث شکست نگاشت‌های EF Core شود

public class Product
{
    private decimal _price;

    public decimal Price
    {
        get => _price;
        set => _price = value >= 0
            ? value
            : throw new ArgumentOutOfRangeException(nameof(value));
    }
}

public class Product
{
    public decimal Price
    {
        get;
        set => field = value >= 0
            ? value
            : throw new ArgumentOutOfRangeException(nameof(value));
    }
}

// نام فیلد در کدهای IL تولیدشده
private decimal '<Price>k__BackingField';

public class OrderLineItem
{
    private int _quantity;

    public int Quantity
    {
        get => _quantity;
        set => _quantity = value;
    }
}

// پیکربندی در OnModelCreating
modelBuilder.Entity<OrderLineItem>()
    .Property(o => o.Quantity)
    .HasField("_quantity");

public class OrderLineItem
{
    public int Quantity { get; set; }
}

modelBuilder.Entity<OrderLineItem>()
    .Property(o => o.Quantity)
    .HasField("_quantity");

modelBuilder.Entity<OrderLineItem>()
    .Property(o => o.Quantity); // EF Core به صورت خودکار فیلد پشتیبان را تشخیص می‌دهد

هشدار: خطای مربوط به HasField در زمان ساخت مدل (Model Building) رخ می‌دهد؛ یعنی زمانی که اولین درخواست به داتابیس ارسال می‌شود یا سرویس در پس‌زمینه اجرا می‌گردد.

CreateMap<OrderLineItem, OrderLineItemDto>()
    .ForMember(dest => dest.Quantity,
        opt => opt.MapFrom(src => GetPrivateField(src, "_quantity")));

CreateMap<OrderLineItem, OrderLineItemDto>()
    .ForMember(dest => dest.Quantity,
        opt => opt.MapFrom(src => src.Quantity));

• جستجوی متدهای HasField: بررسی تمام پیکربندی‌های Fluent API در OnModelCreating.
• بررسی ویژگی [BackingField]: شناسایی اتربیوت‌های اعمال‌شده روی انتیتی‌ها.
• جستجوی متدهای Reflection: بررسی فراخوانی‌های GetField یا GetRuntimeField.
• بررسی پیکربندی Serializerها: برخی Serializerهای قدیمی JSON یا XML از نام فیلدهای خصوصی برای سریالایز کردن استفاده می‌کنند.
• بررسی تست‌های واحد (Unit Tests): اطمینان از اینکه تست‌ها رفتار پراپرتی را می‌سنجند، نه نام فیلد خصوصی را.

# جستجوی متدهای HasField در فایل‌های C#
grep -rn "HasField(" --include=*.cs .

# جستجوی اتربیوت BackingField
grep -rn "BackingField(" --include=*.cs .

# جستجوی فراخوانی‌های Reflection برای دسترسی به فیلدها
grep -rn "GetField(\|GetRuntimeField(" --include=*.cs .