DbContext

بعد ما عملنا الـ Entities (زي الـ Employee class)، الخطوة الجاية إننا نعمل الـ Class اللي هيربط بين الأبلكيشن بتاعنا والـ Database. الـ Class ده هو الـ DbContext.

يعني إيه Understanding DbContext in Entity Framework Core؟

الـ Understanding DbContext in Entity Framework Core ده هو حلقة الوصل الأساسية بين الكود بتاعك والـ Database في الـ Entity Framework Core (أو EF Core).

• مسئوليته إيه؟ هو الـ class اللي من خلاله بتقدر تعمل كل عمليات الـ Database زي:
  • تفتح وتقفل الـ connection.
  • تعمل query للـ data (تجيب بيانات).
  • تعمل save للتغييرات (تضيف، تعدل، تمسح بيانات).
• أكتر من Database؟ أه عادي جدًا. ممكن الأبلكيشن بتاعك يكون فيه أكتر من DbContext، وكل واحد فيهم ممكن يربط على Database مختلفة، أو حتى نفس الـ Database بس بإعدادات (configuration) مختلفة لو محتاج.
• ننظمه إزاي؟ زي ما عملنا folder للـ Models، كويس برضه نعمل folder للـ DbContext ونسميه مثلًا Contexts أو DataAccess.
• التسمية: المتعارف عليه بين المبرمجين إننا بنضيف كلمة DbContext في آخر اسم الكلاس ده، عشان يبقى واضح دوره. زي مثلًا CompanyDbContext أو ApplicationDbContext.

إزاي نعمل DbContext؟

تعالى نعمل الـ DbContext بتاعنا ونسميه CompanyDbContext.

// Put this class inside the created folder (e.g., Contexts)
using Microsoft.EntityFrameworkCore; // Add this using directive
 
// 1. Inherit from DbContext base class
internal class CompanyDbContext : DbContext
{
    // 2. Override the OnConfiguring method
    // Responsible for configuring DB connection (e.g., Connection String)
	protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
	{
        // Configure the database provider (SQL Server) and connection string
		// Use UseSqlServer for SQL Server
 
        // Use modern connection string format
        // Use UseSqlServer extension method which requires Microsoft.EntityFrameworkCore.SqlServer package
		optionsBuilder.UseSqlServer("Server=.;Database=Company;Trusted_Connection=True;Encrypt=False");
        // Note: Added Encrypt=False for local dev/simpler setup; review for production. Important for newer SQL Server driver versions.
 
        // Old connection string format (still works)
		// optionsBuilder.UseSqlServer("Data Source=.;Initial Catalog=Company;Integrated Security=True");
 
        // Can use lambda expression for brevity if it's a single line
        // protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        //  => optionsBuilder.UseSqlServer("Server=.;Database=Company;Trusted_Connection=True;Encrypt=False");
	}
 
    // 3. Next step: Add DbSets for our models here
    // public DbSet<Employee> Employees { get; set; } // To be added later
}

شرح الخطوات:

1. الوراثة (Inheritance): أهم حاجة إن الكلاس بتاعنا (CompanyDbContext) لازم يورث من الكلاس الأساسي اللي اسمه DbContext. الكلاس ده موجود جوه الـ namespace اللي اسمه Microsoft.EntityFrameworkCore (لازم تعمل له using).
2. الـ OnConfiguring Method:
   • دي method موجودة أصلًا في الـ DbContext الأب، وإحنا بنعملها override عشان نحط الإعدادات الخاصة بتاعتنا.
   • وظيفتها الأساسية إننا نحدد للـ EF Core إزاي يوصل للـ Database. ده بيحصل عن طريق الـ optionsBuilder اللي بيجيلنا كـ parameter.
   • بنستخدم optionsBuilder.UseSqlServer(...) (أو UseMySql, UseNpgsql, etc. حسب نوع الـ Database) عشان نقوله إننا هنستخدم النوع ده من الـ Databases. الـ UseSqlServer دي عبارة عن extension method بتيجي من الـ package اللي هنزلها كمان شوية.
   • جوه الـ UseSqlServer بنحط أهم حاجة: الـ Connection String.

الـ NuGet Package المطلوبة

الكلاس DbContext والـ method اللي اسمها UseSqlServer مش موجودين في الـ .NET كده لوحدهم. لازم ننزل package من NuGet عشان نضيفهم للـ project بتاعنا.

• اسم الـ Package: لو هتستخدم Microsoft SQL Server، يبقى محتاج تنزل الـ package دي: Microsoft.EntityFrameworkCore.SqlServer.

• لو Database تانية: كل نوع Database ليه الـ package بتاعته (زي Npgsql.EntityFrameworkCore.PostgreSQL لـ PostgreSQL أو Pomelo.EntityFrameworkCore.MySql لـ MySQL).

• إزاي ننزلها؟

  • من الـ Package Manager Console (PM):

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

    • لو عايز version معين:

      Install-Package Microsoft.EntityFrameworkCore.SqlServer -v 6.0.29 // أو أي رقم version تاني

  • من الـ NuGet Package Manager UI:
    • دوس كليك يمين على الـ Project في الـ Solution Explorer.
    • اختار “Manage NuGet Packages…“.
    • روح على تاب “Browse”.
    • ابحث عن Microsoft.EntityFrameworkCore.SqlServer.
    • اختارها ودوس “Install”.

شرح الـ Connection String

الـ Connection String ده عبارة عن string بيحتوي على كل المعلومات اللي الـ EF Core محتاجها عشان يعرف يفتح connection مع الـ Database بتاعتك. بيتكون من أجزاء (key=value) مفصولة بـ semicolon (;).

الأجزاء المشهورة (في المثال بتاعنا):

• الصيغة الجديدة (المُفضلة):

  • الـ Server=.;
    • الـ Server: ده اسم الـ SQL Server instance اللي عليه الـ Database.
    • القيمة . (نقطة) أو (localdb)\mssqllocaldb أو localhost معناها إن الـ Server موجود على نفس الجهاز اللي الأبلكيشن شغال عليه (local machine).
  • الـ Database=Company;
    • الـ Database: ده اسم الـ Database نفسها اللي عايز تتعامل معاها.
  • الـ Trusted_Connection=True;
    • الـ Trusted_Connection: لما تكون True، ده معناه إنك هتستخدم الـ Windows Authentication. يعني الـ SQL Server هيستخدم نفس حساب الـ Windows اللي إنت عامل بيه login عشان يدخلك، ومش محتاج تكتب username و password.
  • الـ Encrypt=False; (مهم للـ drivers الجديدة)
    • الـ Encrypt: بتحدد إذا كان الاتصال هيتم تشفيره ولا لأ. في الـ versions الجديدة من driver الـ SQL Server، القيمة الافتراضية بقت True، وده ممكن يسبب مشاكل لو الـ Server مش معمول له setup عشان يدعم التشفير بشهادة موثوقة.
    • عشان كده، لو بتطور على جهازك المحلي (local) أو في بيئة مش محتاجة تشفير إجباري، ممكن تحطها False لتسهيل الأمور مؤقتًا.
    • في الـ Production، الأمان أهم طبعًا، وهتحتاج غالبًا تخليها True وتظبط شهادات الأمان صح أو تستخدم TrustServerCertificate=True لو فاهم المخاطر.

• الصيغة القديمة (لسه شغالة):

  • الـ Data Source=.; (نفس معنى Server)
  • الـ Initial Catalog=Company; (نفس معنى Database)
  • الـ Integrated Security=True; (نفس معنى Trusted_Connection=True)

• لو هتستخدم SQL Server Authentication (Username/Password):

  • مش هتستخدم Trusted_Connection أو Integrated Security.
  • هتضيف دول بدلهم:
    • الـ User ID=your_username; (اسم المستخدم بتاع الـ SQL)
    • الـ Password=your_password; (الباسورد بتاع الـ SQL)
    • (وبرضه هتظبط الـ Encrypt حسب البيئة بتاعتك)

إزاي الـ OnConfiguring بتشتغل؟

لما بتيجي في الكود بتاعك وتعمل object جديد من الـ DbContext بتاعك:

// في أي مكان في الكود بتاعك هتحتاج تتعامل مع الداتابيز
CompanyDbContext dbContext = new CompanyDbContext();

اللي بيحصل كالتالي:

1. الـ Constructor بتاع CompanyDbContext بيشتغل (حتى لو إنت مكتبتش constructor فاضي، الـ compiler بيعمل واحد افتراضي).
2. الـ Constructor ده (بشكل ضمني أو صريح لو عملت chaining) بينادي على الـ constructor بتاع الـ base class اللي هو DbContext.
3. كجزء من عملية الـ initialization اللي بيعملها الـ constructor بتاع DbContext الأساسي، هو بيروح ينادي على الـ OnConfiguring method.
4. بما إن إحنا عاملين override للـ OnConfiguring في الكلاس بتاعنا (CompanyDbContext)، فالنسخة بتاعتنا هي اللي هتتنفذ.
5. النسخة بتاعتنا هتحط الإعدادات اللي كتبناها (زي UseSqlServer مع الـ Connection String) جوه الـ optionsBuilder.
6. كده الـ DbContext بقى جاهز ومعاه كل المعلومات اللي محتاجها عشان يوصل للـ Database.

علاقة ده بالـ DbContextOptions:

الـ optionsBuilder اللي بنستخدمه جوه OnConfiguring هو من نوع DbContextOptionsBuilder. ده الـ object اللي الـ EF Core بيديهولنا عشان نبني (build) الـ options اللي الـ DbContext هيستخدمها. الـ options دي في الآخر بتبقى object من نوع DbContextOptions (أو DbContextOptions<TContext>).

فيه طرق تانية لتمرير الـ options دي للـ DbContext (زي إننا نعمل constructor في CompanyDbContext بياخد DbContextOptions<CompanyDbContext> كـ parameter ونمررها للـ base constructor)، ودي الطريقة الأكثر شيوعًا لما بنستخدم DNAPI Dependency Injection. لكن طريقة الـ OnConfiguring دي بسيطة ومباشرة لو الإعدادات ثابتة ومش محتاجة تتغير من بره.

دلوقتي الـ DbContext بتاعنا جاهز يعرف يوصل للـ Database. الخطوة الجاية إننا نعرفه على الـ Models بتاعتنا (زي Employee) عشان يقدر يحولها لـ Table. ده بيتم عن طريق إضافة DbSet properties جوه الـ DbContext.