✅ کوئری کامل و بهینه برای پروژه کتابخانه با همه ویژگی‌هایی که گفتی

csharp
var query = _context.Books
    .AsNoTracking() // 1️⃣ سبک‌سازی کوئری فقط خواندنی

    // 2️⃣ فیلتر وضعیت کتاب (موجود یا فروخته‌شده)
    .Where(b => statusFilter == "available" ? b.IsAvailable :
                statusFilter == "sold" ? !b.IsAvailable : true)

    // 3️⃣ جستجو در عنوان کتاب یا نام نویسنده
    .Where(b => string.IsNullOrEmpty(search) ||
                b.Title.Contains(search) ||
                b.Author.FullName.Contains(search))

    // 4️⃣ مرتب‌سازی بر اساس تاریخ ثبت (جدیدترین یا قدیمی‌ترین)
    .OrderByDescending(b => sort == "new" ? b.Id : 0)
    .ThenBy(b => sort == "old" ? b.Id : 0)

    // 5️⃣ صفحه‌بندی بر اساس تعداد کل رکوردها و صفحه فعلی
    .Skip((page - 1) * pageSize)
    .Take(pageSize)

    // 6️⃣ انتخاب فیلدهای مورد نیاز برای نمایش
    .Select(b => new
    {
        b.Id,
        b.Title,
        b.IsAvailable,
        AuthorName = b.Author.FullName
    })

    // 7️⃣ اجرای کوئری و گرفتن داده‌ها
    .ToList();

🔍 تفاوت‌های اصلی بین دو روش | تفاوت | روش اول (if و switch) | روش دوم (شرط داخل Where و OrderBy) | |-------|-----------------------------|----------------------------------------| | سبک نوشتن | مرحله‌مرحله با شرط‌های جدا | همه‌چیز در یک زنجیره‌ی متصل | | خوانایی | ✅ واضح‌تر برای مبتدی‌ها | کمی فشرده‌تر ولی حرفه‌ای‌تر | | انعطاف‌پذیری | راحت‌تر برای شرط‌های پیچیده | مناسب برای کوئری‌های ساده و مستقیم | | قابل تست بودن | می‌تونی هر مرحله رو جدا تست بزنی | سخت‌تر برای دیباگ مرحله‌ای | | کنترل منطق | شرط‌ها جدا و قابل تغییر | شرط‌ها داخل کوئری، کمتر قابل تغییر در لحظه | | مناسب برای پروژه‌های بزرگ | ✅ بهتر برای منطق پیچیده | مناسب برای لیست‌های سبک و سریع | | تعداد متغیرها | از query چند بار استفاده می‌شه | فقط یک بار تعریف و استفاده می‌شه |

پروژه مدیریت نویسنده و کتاب

الان برات یک لیست کامل و مرتب از اجزای پروژه فعلی آماده می‌کنم تا بتونی در کانالت منتشرش کنی. این لیست هم برای معرفی پروژه‌ات خوبه، هم برای آموزش به دیگران که مثل خودت در مسیر یادگیری هستن. --- ## 📚 پروژه مدیریت نویسنده و کتاب با ASP.NET Core MVC ### ✅ مدل‌ها (Models) -

Author

: شامل

Id

,

FullName

,

Books

-

Book

: شامل

Id

,

Title

,

IsAvailable

,

AuthorId

,

Author

--- ### ✅ روابط بین مدل‌ها - هر نویسنده می‌تواند چند کتاب داشته باشد (

One-to-Many

) - حذف نویسنده فقط در صورتی مجاز است که کتاب نداشته باشد (DeleteBehavior.Restrict) --- ### ✅ کنترلرها (Controllers) -

AuthorController

: لیست، افزودن، ویرایش، حذف نویسنده با شمارش کتاب‌ها -

BookController

: لیست، افزودن، ویرایش، حذف کتاب با فیلتر و صفحه‌بندی -

HomeController

: نمایش نویسنده‌ها و کتاب‌هایشان در صفحه اصلی +

MoreBooks

--- ### ✅ Viewها (صفحات Razor) -

Author/Index

,

Create

,

Edit

,

Delete

با شمارش کتاب‌ها -

Book/Index

,

Create

,

Edit

,

Delete

با فیلتر و صفحه‌بندی -

Home/Index

: نمایش نویسنده‌ها و کتاب‌هایشان (تا ۶ عدد) -

Home/MoreBooks

: نمایش همه کتاب‌های یک نویسنده با صفحه‌بندی --- ### ✅ تنظیمات EF Core در

OnModelCreating

- تعریف رابطه نویسنده و کتاب با DeleteBehavior.Restrict - تنظیم طول فیلدها و الزامی بودن - جلوگیری از حذف نویسنده دارای کتاب - مقدار پیش‌فرض برای

IsAvailable

--- ### ✅ امکانات ویژه - فیلتر کتاب‌ها بر اساس وضعیت و عنوان - صفحه‌بندی برای لیست کتاب‌ها و نویسنده‌ها - پیام هشدار هنگام تلاش برای حذف نویسنده دارای کتاب - طراحی با Bootstrap برای زیبایی و واکنش‌گرایی

اگر تمام تنظیماتی که تا الان گفتیم رو در

ModelBuilder

پیاده‌سازی کنی، نتیجه‌اش یک مدل داده‌ای کاملاً حرفه‌ای، امن، و قابل توسعه خواهد بود—درست مثل پروژه‌های واقعی تولیدی. این یعنی: - جلوگیری از خطاهای حذف ناخواسته - اعتبارسنجی داده‌ها از سمت دیتابیس - ساختار تمیز و قابل فهم برای توسعه‌دهنده‌های دیگر - آمادگی برای مهاجرت به پروژه‌های بزرگ‌تر ---

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // جدول نویسنده
    modelBuilder.Entity<Author>(entity =>
    {
        entity.Property(a => a.FullName)
              .IsRequired()
              .HasMaxLength(100);

        entity.HasMany(a => a.Books)
              .WithOne(b => b.Author)
              .HasForeignKey(b => b.AuthorId)
              .OnDelete(DeleteBehavior.Restrict); // جلوگیری از حذف نویسنده دارای کتاب
    });

    // جدول کتاب
    modelBuilder.Entity<Book>(entity =>
    {
        entity.Property(b => b.Title)
              .IsRequired()
              .HasMaxLength(150);

        entity.Property(b => b.IsAvailable)
              .HasDefaultValue(true);

        entity.HasIndex(b => new { b.Title, b.AuthorId })
              .IsUnique(); // جلوگیری از ثبت کتاب تکراری برای یک نویسنده
    });
}

الان کدی که در

OnModelCreating

هست رو به‌صورت لیست کامل و توضیح‌دار برات آماده می‌کنم تا هم برای خودت مرور بشه. این تنظیمات پایه‌ای EF Core هستن که پروژه‌ات رو حرفه‌ای و قابل اعتماد می‌کنن. --- ## 📦 لیست تنظیمات

ModelBuilder

با توضیح کامل ### 1️⃣ entity.Property(a => a.FullName).IsRequired().HasMaxLength(100); - مدل:

Author

- توضیح: فیلد

FullName

باید حتماً مقدار داشته باشه (

IsRequired

) و حداکثر ۱۰۰ کاراکتر باشه. - ✅ جلوگیری از ورود داده‌های ناقص یا طولانی --- ### 2️⃣ entity.HasMany(a => a.Books).WithOne(b => b.Author)... .HasForeignKey(b => b.AuthorId) .OnDelete(DeleteBehavior.Restrict); - مدل: رابطه بین

Author

و

Book

- توضیح: هر نویسنده می‌تونه چند کتاب داشته باشه، ولی اگر کتابی وجود داشته باشه، نویسنده قابل حذف نیست. - ✅ جلوگیری از حذف ناخواسته نویسنده‌ای که کتاب دارد --- ### 3️⃣ entity.Property(b => b.Title).IsRequired().HasMaxLength(150); - مدل:

Book

- توضیح: عنوان کتاب باید وارد شود و حداکثر ۱۵۰ کاراکتر باشد. - ✅ اعتبارسنجی داده‌ها و جلوگیری از خطاهای فرم --- ### 4️⃣ entity.Property(b => b.IsAvailable).HasDefaultValue(true); - مدل:

Book

- توضیح: وضعیت موجود بودن کتاب به‌صورت پیش‌فرض "موجود" تنظیم می‌شود. - ✅ ساده‌سازی فرم افزودن کتاب و کاهش خطای کاربر --- ### 5️⃣ entity.HasIndex(b => new { b.Title, b.AuthorId }).IsUnique(); - مدل:

Book

- توضیح: ترکیب عنوان کتاب و شناسه نویسنده باید یکتا باشد. یعنی یک نویسنده نمی‌تواند دو کتاب با عنوان یکسان داشته باشد. - ✅ جلوگیری از ثبت کتاب‌های تکراری برای یک نویسنده --- ## ✨ نتیجه نهایی | ویژگی | تأثیر در پروژه | |-------|----------------| | اعتبارسنجی فیلدها | جلوگیری از داده‌های ناقص یا اشتباه | | کنترل حذف | حفظ یکپارچگی داده‌ها | | مقدار پیش‌فرض | ساده‌سازی فرم‌ها | | ایندکس یکتا | جلوگیری از تکرار داده‌ها | | رابطه دقیق | ساختار حرفه‌ای و قابل توسعه

🎯 درس جدید: تنظیم دقیق مدل‌ها با ModelBuilder در EF Core در این مرحله از پروژه مدیریت نویسنده و کتاب، وارد دنیای حرفه‌ای Entity Framework Core شدیم. با استفاده از

ModelBuilder

در متد `OnModelCreating`، ساختار دیتابیس رو دقیق‌تر و امن‌تر کردیم. 🔧 تنظیماتی که اضافه شد: 1️⃣ رابطه نویسنده و کتاب هر نویسنده می‌تونه چند کتاب داشته باشه، اما اگر کتابی ثبت شده باشه، حذف نویسنده ممنوعه (DeleteBehavior.Restrict) 2️⃣ اعتبارسنجی فیلدها - نام نویسنده: الزامی و حداکثر ۱۰۰ کاراکتر - عنوان کتاب: الزامی و حداکثر ۱۵۰ کاراکتر 3️⃣ مقدار پیش‌فرض برای وضعیت کتاب کتاب‌ها به‌صورت پیش‌فرض "موجود" ثبت می‌شن (

IsAvailable = true

) 4️⃣ جلوگیری از ثبت کتاب تکراری برای یک نویسنده ترکیب

Title

و

AuthorId

باید یکتا باشه—یعنی یک نویسنده نمی‌تونه دو کتاب با عنوان یکسان داشته باشه 📌 این تنظیمات باعث می‌شن پروژه‌مون هم حرفه‌ای‌تر بشه، هم از خطاهای رایج جلوگیری کنه.

پیکربندی پایگاه داده در EF Core از DBContext تا Fluent API ساخته شده از هوش مصنوعی

بیا با هم یه پادکست آموزشی طراحی کنیم درباره‌ی کانتکس، مدل‌بیلدر و مدل‌کریتینگ در EF Core و ASP.NET Core MVC. این پادکست می‌تونه هم برای یادگیری خودت مفید باشه، هم برای تولید محتوا در کانالت. --- 🎧 عنوان پادکست: «در دل DbContext: مدل‌سازی حرفه‌ای با ModelBuilder و OnModelCreating در ASP.NET Core MVC» --- 🎙️ مقدمه سلام! امروز می‌خوایم بریم سراغ قلب ارتباط با دیتابیس در ASP.NET Core MVC—یعنی کلاس DbContext. با هم بررسی می‌کنیم که چطور با ModelBuilder و متد OnModelCreating می‌تونیم ساختار دیتابیس رو دقیق، حرفه‌ای و قابل توسعه طراحی کنیم. --- 🧩 بخش اول: DbContext چیست؟ - کلاس مرکزی برای ارتباط با دیتابیس - شامل DbSet‌ها برای هر مدل (مثل Books, Users, Orders) - EF Core از این کلاس برای ساخت کوئری، ذخیره‌سازی و بارگذاری داده استفاده می‌کنه --- 🔹 بخش دوم: OnModelCreating و ModelBuilder ✅ OnModelCreating - متدی در DbContext که EF Core هنگام راه‌اندازی صدا می‌زنه - داخلش می‌تونی ساختار جدول‌ها، روابط، محدودیت‌ها و رفتارها رو تعریف کنی ✅ ModelBuilder - شیء ورودی به OnModelCreating - باهاش می‌تونی مدل‌ها رو پیکربندی کنی با Fluent API --- 🔧 بخش سوم: چه کارهایی می‌تونیم با ModelBuilder انجام بدیم؟ 1️⃣ تعریف کلید اصلی و ترکیبی csharp modelBuilder.Entity<Book>().HasKey(b => b.Id); 2️⃣ تعریف روابط بین جدول‌ها csharp modelBuilder.Entity<Book>() .HasOne(b => b.Author) .WithMany(a => a.Books) .HasForeignKey(b => b.AuthorId); 3️⃣ جلوگیری از حذف آیتم‌های مرتبط csharp .OnDelete(DeleteBehavior.Restrict); 4️⃣ محدودیت روی فیلدها csharp .Property(b => b.Title).HasMaxLength(200).IsRequired(); 5️⃣ مقدار پیش‌فرض csharp .Property(b => b.IsAvailable).HasDefaultValue(true); 6️⃣ فیلتر جهانی csharp .HasQueryFilter(p => p.IsActive); --- 📋 بخش چهارم: آیا ModelBuilder و OnModelCreating جدا هستند؟ - ModelBuilder فقط داخل OnModelCreating استفاده می‌شه - OnModelCreating متدی مستقل در DbContext هست - می‌تونی پیکربندی‌ها رو به کلاس‌های جداگانه منتقل کنی با ApplyConfiguration() برای نظم بیشتر --- 🎯 جمع‌بندی پادکست با استفاده از ModelBuilder در OnModelCreating می‌تونی: - ساختار دیتابیس رو دقیق کنترل کنی - روابط بین جدول‌ها رو تعریف کنی - از حذف ناخواسته داده‌های مرتبط جلوگیری کنی - محدودیت‌ها، ایندکس‌ها و فیلترهای پیش‌فرض رو تنظیم کنی - پروژه‌ت رو حرفه‌ای، امن و قابل توسعه بسازی

همش این نیست—دنیای EF Core و ASP.NET Core MVC خیلی گسترده‌تره! 😄 اون چیزی که تا حالا گفتیم مربوط به پیکربندی مدل‌ها با ModelBuilder و OnModelCreating بود، ولی کلی قابلیت دیگه هم وجود داره که مکمل این بخش‌ها هستن و پروژه‌ت رو حرفه‌ای‌تر می‌کنن. --- 🧩 چیزهای دیگر که کنار ModelBuilder و OnModelCreating وجود دارند: 🔹 ۱. Data Annotations پیکربندی مدل‌ها با استفاده از ویژگی‌های تزئینی روی کلاس‌ها: csharp [Required] [MaxLength(100)] public string Title { get; set; } 📌 ساده‌تر از Fluent API، ولی محدودتر --- 🔹 ۲. Migration و به‌روزرسانی دیتابیس - ایجاد فایل‌های مهاجرت با Add-Migration - اعمال تغییرات با Update-Database - بررسی تاریخچه تغییرات دیتابیس 📌 برای هماهنگی مدل‌ها با دیتابیس واقعی --- 🔹 ۳. Seed Data (داده اولیه) csharp modelBuilder.Entity<Category>().HasData( new Category { Id = 1, Name = "ASP.NET" }, new Category { Id = 2, Name = "EF Core" } ); 📌 برای پر کردن دیتابیس با داده‌های پیش‌فرض --- 🔹 ۴. Global Query Filters csharp modelBuilder.Entity<Product>() .HasQueryFilter(p => p.IsActive); 📌 اعمال فیلتر روی همه‌ی کوئری‌ها به‌صورت خودکار --- 🔹 ۵. Value Conversions تبدیل نوع داده‌ها هنگام ذخیره‌سازی: csharp modelBuilder.Entity<User>() .Property(u => u.IsAdmin) .HasConversion<int>(); 📌 برای تبدیل bool به int یا enum به string --- 🔹 ۶. Shadow Properties فیلدهایی که در کلاس مدل نیستن ولی در دیتابیس هستن: csharp modelBuilder.Entity<Product>() .Property<DateTime>("LastUpdated"); 📌 برای ذخیره اطلاعات سیستمی بدون تغییر مدل --- 🔹 ۷. Table Splitting ذخیره چند کلاس در یک جدول: csharp modelBuilder.Entity<Order>().ToTable("Orders"); modelBuilder.Entity<Invoice>().ToTable("Orders"); 📌 برای بهینه‌سازی ساختار دیتابیس --- 🔹 ۸. Query Types / Keyless Entities برای نمایش داده‌هایی که کلید اصلی ندارن: csharp modelBuilder.Entity<ReportView>().HasNoKey(); 📌 مناسب برای گزارش‌ها و ویوهای فقط‌خواندنی --- 🔹 ۹. Change Tracking و State Management بررسی وضعیت رکوردها: csharp context.Entry(book).State = EntityState.Modified; 📌 برای کنترل دقیق عملیات CRUD --- 🔹 ۱۰. Interceptors و Logging شنود عملیات EF Core: csharp optionsBuilder.AddInterceptors(new MyInterceptor()); 📌 برای لاگ‌گیری، امنیت، یا مانیتورینگ --- 🎯 نتیجه‌گیری پس ModelBuilder و OnModelCreating فقط بخشی از دنیای EF Core هستن. کنار اون‌ها کلی ابزار و تکنیک دیگه وجود داره که بهت کمک می‌کنن: - ساخت دیتابیس حرفه‌ای - کنترل رفتار داده‌ها - بهینه‌سازی عملکرد - تولید گزارش و داشبورد - و حتی امنیت و لاگ‌گیری ---

پاسخ بستگی داره که هدفت چی باشه—آیا فقط می‌خوای بررسی کنی که نویسنده کتاب دارد یا نه؟ یا می‌خوای اطلاعات کامل نویسنده و کتاب‌ها را واکشی کنی؟ بیایم دقیق مقایسه کنیم: --- ✅ روش اول: واکشی فقط نام اولین کتاب

csharp
var firstTitle = _context.Books
    .Where(b => b.AuthorId == id)
    .Select(b => b.Title)
    .FirstOrDefault();

🔹 هدف: فقط گرفتن نام اولین کتاب 🔹 مزایا: - سریع‌تر و سبک‌تر - فقط یک ستون (Title) واکشی می‌شود - مناسب برای بررسی ساده یا نمایش خلاصه 🔹 معایب: - اطلاعات نویسنده واکشی نمی‌شود - اگر بخواهی لیست کامل کتاب‌ها یا جزئیات بیشتر داشته باشی، کافی نیست --- ✅ روش دوم: واکشی نویسنده با لیست کتاب‌ها

csharp
var author = _context.Authors
    .Include(a => a.Books)
    .FirstOrDefault(a => a.Id == id);

🔹 هدف: گرفتن نویسنده و تمام کتاب‌هایش 🔹 مزایا: - اطلاعات کامل نویسنده و کتاب‌ها در دسترس است - مناسب برای Viewهایی که جزئیات کامل را نمایش می‌دهند - می‌توانی بررسی کنی author.Books.Any() یا لیست را نمایش دهی 🔹 معایب: - سنگین‌تر از روش اول - در دیتابیس‌های بزرگ ممکن است کندتر باشد --- ✨ نتیجه‌گیری برای دفترت | هدف | روش بهتر | دلیل | |------|-----------|--------| | فقط بررسی یا نمایش یک کتاب | firstTitle | سبک و سریع | | نمایش نویسنده و همه کتاب‌ها | author + Include | کامل و دقیق | | پروژه‌های بزرگ با داده زیاد | firstTitle | بهینه‌تر | | فرم‌های جزئیات یا حذف | author + Include | چون نیاز به بررسی Books.Any() داری |

اگر بخوای همون داده‌ها رو با Select بنویسی، یعنی به‌جای واکشی کامل شیء Author، فقط فیلدهای خاصی رو واکشی کنی—و این باعث می‌شه کد سبک‌تر و سریع‌تر بشه، مخصوصاً در دیتابیس‌های بزرگ. --- ✅ تبدیل Include + FirstOrDefault به Select کد اصلی:

csharp
var author = _context.Authors
    .Include(a => a.Books)
    .FirstOrDefault(a => a.Id == id);

🔹 این کد کل شیء Author و لیست Books رو واکشی می‌کنه 🔹 اگر فقط بعضی فیلدها رو بخوای، می‌تونی از Select استفاده کنی: --- 🎯 نسخه با Select

csharp
var authorData = _context.Authors
    .Where(a => a.Id == id)
    .Select(a => new
    {
        a.Id,
        a.FullName,
        BookTitles = a.Books.Select(b => b.Title).ToList()
    })
    .FirstOrDefault();

🔹 این کد فقط Id, FullName و لیست Title کتاب‌ها رو واکشی می‌کنه 🔹 خروجی یک شیء بی‌نام (anonymous type) هست—not کلاس Author --- 🧠 تفاوت‌ها | مورد | Include + FirstOrDefault | Select + FirstOrDefault | |------|-----------------------------|----------------------------| | نوع خروجی | Author | شیء بی‌نام | | حجم داده | زیادتر | سبک‌تر | | انعطاف در انتخاب فیلدها | کم | زیاد | | مناسب برای View | بله | بله، اگر فقط فیلدهای خاص بخواهی | | مناسب برای حذف یا ویرایش | بهتر است از Author استفاده شود | چون نیاز به شیء کامل داری | --- ✨ نتیجه‌گیری برای دفترت | هدف | روش بهتر | دلیل | |------|-----------|--------| | نمایش خلاصه اطلاعات | Select | سبک‌تر و سریع‌تر | | عملیات حذف یا ویرایش | Include + FirstOrDefault | نیاز به شیء کامل | | واکشی فقط نام کتاب‌ها | Select(a => new { ... }) | دقیق و بهینه |

var firstTitle = _context.Books .Where(b => b.AuthorId == id) .Select(b => b.Title) .FirstOrDefault(); دقیقاً همین کد به‌درستی کار می‌کند برای اینکه بفهمی آیا نویسنده کتاب دارد یا نه 👌 بیایم دقیق بررسی کنیم که چرا این روش مؤثر و بهینه است: --- ✅ کد بررسی داشتن کتاب با FirstOrDefault

csharp
var firstTitle = _context.Books
    .Where(b => b.AuthorId == id)
    .Select(b => b.Title)
    .FirstOrDefault();

🔹 این کد می‌ره سراغ جدول Books 🔹 فقط کتاب‌هایی رو بررسی می‌کنه که AuthorId برابر با id باشه 🔹 فقط ستون Title رو واکشی می‌کنه—not کل شیء کتاب 🔹 فقط اولین عنوان کتاب رو می‌گیره، یا null اگر هیچ کتابی نباشه --- 🎯 بررسی شرط

csharp
if (firstTitle != null)
{
    // نویسنده کتاب دارد
}
else
{
    // نویسنده کتاب ندارد
}

✅ این شرط کاملاً درست و سبک هست ✅ مناسب برای پروژه‌هایی که فقط می‌خوای بررسی کنی نویسنده کتاب دارد یا نه ✅ سریع‌تر از Include و واکشی کل لیست کتاب‌ها --- ✨ مزایای این روش | مزیت | توضیح | |------|-------| | سبک و سریع | فقط یک مقدار واکشی می‌شود—not کل لیست | | بدون نیاز به Include | چون فقط از جدول Books استفاده می‌کنی | | مناسب برای شرط حذف | چون فقط بررسی می‌کنی که کتاب دارد یا نه | | قابل استفاده در پروژه‌های بزرگ | چون فشار کمتری به دیتابیس وارد می‌کند