بیایید این کد را با هم بررسی کنیم و هر بخش از آن را توضیح دهیم:
Namespace و تعریف کلاس
namespace WebApplication5.Models.Entities
{
public class Order
{
namespace WebApplication5.Models.Entities:
این بخش نشان میدهد که کلاس Order در فضای نام WebApplication5.Models.Entities قرار دارد. فضای نامها برای سازماندهی و گروهبندی کلاسها و سایر اعضای برنامه استفاده میشوند.
public class Order:
این بخش نشان میدهد که یک کلاس عمومی به نام Order تعریف شده است. کلاسها به عنوان الگوهایی برای ایجاد اشیاء استفاده میشوند و اعضای کلاس (مانند ویژگیها و متدها) را در بر میگیرند.
ویژگیهای کلاس
public long Id { get; set; }
public DateTime CraetDate { get; set; }
public string Address { get; set; }
public long Id { get; set; }:
این ویژگی، یک شناسه منحصر به فرد (Id) برای هر شیء از کلاس Order است. نوع داده آن long است و دارای خصوصیات getter و setter است.
public DateTime CraetDate { get; set; }:
این ویژگی، تاریخ ایجاد سفارش (CraetDate) را نگه میدارد. نوع داده آن DateTime است. لطفاً توجه داشته باشید که نام ویژگی اشتباه تایپی دارد و باید به CreateDate تغییر یابد.
public string Address { get; set; }:
این ویژگی، آدرس مشتری برای سفارش (Address) را نگه میدارد. نوع داده آن string است.
روابط و ناوبریها
public virtual Customer Customer { get; set; }
public long CustomerId { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
}
}
public virtual Customer Customer { get; set; }:
این ویژگی یک رابطه ناوبری (navigation property) برای موجودیت Customer است. این ویژگی به شما امکان میدهد تا مستقیماً به شیء Customer مرتبط با این Order دسترسی داشته باشید. virtual به Entity Framework Core اجازه میدهد که بارگذاری تنبل (lazy loading) را پشتیبانی کند.
public long CustomerId { get; set; }:
این ویژگی یک کلید خارجی (CustomerId) است که به Customer مرتبط با این سفارش اشاره میکند. نوع داده آن long است و ارتباط بین Order و Customer را برقرار میکند.
public virtual ICollection<OrderDetil> OrderDetils { get; set; }:
این ویژگی یک مجموعه ناوبری (navigation property) برای موجودیتهای OrderDetil است. این ویژگی به شما امکان میدهد تا به مجموعهای از جزئیات سفارش (order details) دسترسی داشته باشید که با این سفارش مرتبط هستند. ICollection<OrderDetil> نوع داده مجموعهای است که برای نگهداری چندین شیء OrderDetil استفاده میشود.
نتیجهگیری
این کلاس Order نمایانگر یک مدل دادهای برای یک سفارش است که شامل ویژگیهایی مانند شناسه، تاریخ ایجاد، آدرس، و روابط با موجودیتهای Customer و OrderDetil است. این مدل برای استفاده در Entity Framework Core طراحی شده است و به شما امکان میدهد تا اطلاعات سفارشات را به صورت شیءگرا در کد خود مدیریت کنید و با پایگاه داده تعامل داشته باشید.
پوشه Models و پوشه Entities و فایل OrderDetil.cs
namespace WebApplication5.Models.Entities
{
public class OrderDetil
{
public long Id { get; set; }
public int Count { get; set; }
public virtual Order Order { get; set; }
public long OrderId { get; set; }
public virtual Product Product { get; set; }
public long ProductId { get; set; }
}
}
بیایید این کد را با هم بررسی کنیم و هر بخش از آن را توضیح دهیم:
Namespace و تعریف کلاس
namespace WebApplication5.Models.Entities
{
public class OrderDetil
{
namespace WebApplication5.Models.Entities:
این بخش نشان میدهد که کلاس OrderDetil در فضای نام WebApplication5.Models.Entities قرار دارد. فضای نامها برای سازماندهی و گروهبندی کلاسها و سایر اعضای برنامه استفاده میشوند.
public class OrderDetil:
این بخش نشان میدهد که یک کلاس عمومی به نام OrderDetil تعریف شده است. کلاسها به عنوان الگوهایی برای ایجاد اشیاء استفاده میشوند و اعضای کلاس (مانند ویژگیها و متدها) را در بر میگیرند.
ویژگیهای کلاس
public long Id { get; set; }
public int Count { get; set; }
public long Id { get; set; }:
این ویژگی، یک شناسه منحصر به فرد (Id) برای هر شیء از کلاس OrderDetil است. نوع داده آن long است و دارای خصوصیات getter و setter است.
public int Count { get; set; }:
این ویژگی، تعداد آیتمهای موجود در جزئیات سفارش (Count) را نگه میدارد. نوع داده آن int است.
روابط و ناوبریها
public virtual Order Order { get; set; }
public long OrderId { get; set; }
public virtual Product Product { get; set; }
public long ProductId { get; set; }
}
}
public virtual Order Order { get; set; }:
این ویژگی یک رابطه ناوبری (navigation property) برای موجودیت Order است. این ویژگی به شما امکان میدهد تا مستقیماً به شیء Order مرتبط با این OrderDetil دسترسی داشته باشید. virtual به Entity Framework Core اجازه میدهد که بارگذاری تنبل (lazy loading) را پشتیبانی کند.
public long OrderId { get; set; }:
این ویژگی یک کلید خارجی (OrderId) است که به سفارش مرتبط با این جزئیات سفارش اشاره میکند. نوع داده آن long است و ارتباط بین OrderDetil و Order را برقرار میکند.
public virtual Product Product { get; set; }:
این ویژگی یک رابطه ناوبری برای موجودیت Product است. این ویژگی به شما امکان میدهد تا مستقیماً به شیء Product مرتبط با این OrderDetil دسترسی داشته باشید.
public long ProductId { get; set; }:
این ویژگی یک کلید خارجی (ProductId) است که به محصول مرتبط با این جزئیات سفارش اشاره میکند. نوع داده آن long است و ارتباط بین OrderDetil و Product را برقرار میکند.
نتیجهگیری
این کلاس OrderDetil نمایانگر یک مدل دادهای برای جزئیات سفارش است که شامل ویژگیهایی مانند شناسه، تعداد آیتمها، و روابط با موجودیتهای Order و Product است. این مدل برای استفاده در Entity Framework Core طراحی شده است و به شما امکان میدهد تا اطلاعات جزئیات سفارشات را به صورت شیءگرا در کد خود مدیریت کنید و با پایگاه داده تعامل داشته باشید.
پوشه Models و پوشه Entities و فایل Product.cs
namespace WebApplication5.Models.Entities
{
public class Product
{
internal object warranty;
public long Id { get; set; }
public string Images { get; set; }
public string Name { get; set; }
public string Brand { get; set; }
public int Price { get; set; }
public float Ram { get; set; }
public OStype OS { get; set; }
public string Network { get; set; }
public int Inventory { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
public Warranty Warranty { get; set; }
}
public enum OStype
{
IOS=0,
Androide=1,
WindowsPhone=2
}
}
بیایید کد کلاس Product و OStype را به طور کامل بررسی کنیم و هر بخش از آن را توضیح دهیم.
Namespace و تعریف کلاس
namespace WebApplication5.Models.Entities
{
public class Product
{
namespace WebApplication5.Models.Entities:
این بخش نشان میدهد که کلاس Product در فضای نام WebApplication5.Models.Entities قرار دارد. فضای نامها برای سازماندهی و گروهبندی کلاسها و سایر اعضای برنامه استفاده میشوند.
public class Product:
این بخش نشان میدهد که یک کلاس عمومی به نام Product تعریف شده است. کلاسها به عنوان الگوهایی برای ایجاد اشیاء استفاده میشوند و اعضای کلاس (مانند ویژگیها و متدها) را در بر میگیرند.
ویژگیها و فیلدهای کلاس
internal object warranty;
public long Id { get; set; }
public string Images { get; set; }
public string Name { get; set; }
public string Brand { get; set; }
public int Price { get; set; }
public float Ram { get; set; }
public OStype OS { get; set; }
public string Network { get; set; }
public int Inventory { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
public Warranty Warranty { get; set; }
}
internal object warranty:
این یک فیلد داخلی است که به عنوان یک شیء warranty تعریف شده است. internal به این معنی است که این فیلد فقط در داخل فضای نام فعلی قابل دسترسی است.
public long Id { get; set; }:
این ویژگی، یک شناسه منحصر به فرد (Id) برای هر شیء از کلاس Product است. نوع داده آن long است.
public string Images { get; set; }:
این ویژگی، تصاویر محصول (Images) را نگه میدارد. نوع داده آن string است.
public string Name { get; set; }:
این ویژگی، نام محصول (Name) را نگه میدارد. نوع داده آن string است.
public string Brand { get; set; }:
این ویژگی، برند محصول (Brand) را نگه میدارد. نوع داده آن string است.
public int Price { get; set; }:
این ویژگی، قیمت محصول (Price) را نگه میدارد. نوع داده آن int است.
public float Ram { get; set; }:
این ویژگی، میزان حافظه رم محصول (Ram) را نگه میدارد. نوع داده آن float است.
public OStype OS { get; set; }:
این ویژگی، سیستم عامل محصول (OS) را نگه میدارد. نوع داده آن یک enum به نام OStype است.
public string Network { get; set; }:
این ویژگی، نوع شبکه محصول (Network) را نگه میدارد. نوع داده آن string است.
public int Inventory { get; set; }:
این ویژگی، موجودی انبار محصول (Inventory) را نگه میدارد. نوع داده آن int است.
public virtual ICollection<OrderDetil> OrderDetils { get; set; }:
این ویژگی یک رابطه ناوبری (navigation property) برای موجودیتهای OrderDetil است. این ویژگی به شما امکان میدهد تا به مجموعهای از جزئیات سفارشات که با این محصول مرتبط هستند، دسترسی داشته باشید. ICollection<OrderDetil> نوع دادهای است که برای نگهداری چندین شیء OrderDetil استفاده میشود.
public Warranty Warranty { get; set; }:
این ویژگی یک رابطه ناوبری برای موجودیت Warranty است که تضمین یا گارانتی محصول را نگهداری میکند.
تعریف Enum
public enum OStype
{
IOS = 0,
Androide = 1,
WindowsPhone = 2
}
}
public enum OStype:
این یک enum عمومی به نام OStype است که نوع سیستمعاملهای مختلف را تعریف میکند.
IOS = 0: نمایانگر iOS با مقدار 0.
Androide = 1: نمایانگر Android با مقدار 1.
WindowsPhone = 2: نمایانگر Windows Phone با مقدار 2.
نتیجهگیری
کلاس Product نمایانگر یک مدل دادهای برای محصولات است که شامل ویژگیهایی مانند شناسه، تصاویر، نام، برند، قیمت، حافظه رم، سیستمعامل، شبکه، موجودی و روابط با موجودیتهای OrderDetil و Warranty است. این مدل برای استفاده در Entity Framework Core طراحی شده است و به شما امکان میدهد تا اطلاعات محصولات را به صورت شیءگرا در کد خود مدیریت کنید و با پایگاه داده تعامل داشته باشید. Enum OStype نیز نوع سیستمعامل محصولات را مشخص میکند.
پوشه Models و پوشه Entities و فایل Warranty.cs
namespace WebApplication5.Models.Entities
{
public class Warranty
{
public Product Product { get; set; }
public long ProductId { get; set; }
public int WarrantyPeriod { get; set; }
}
}
بیایید این کد را با هم بررسی کنیم و هر بخش از آن را توضیح دهیم:
Namespace و تعریف کلاس
namespace WebApplication5.Models.Entities
{
public class Warranty
{
namespace WebApplication5.Models.Entities:
این بخش نشان میدهد که کلاس Warranty در فضای نام WebApplication5.Models.Entities قرار دارد. فضای نامها برای سازماندهی و گروهبندی کلاسها و سایر اعضای برنامه استفاده میشوند.
public class Warranty:
این بخش نشان میدهد که یک کلاس عمومی به نام Warranty تعریف شده است. کلاسها به عنوان الگوهایی برای ایجاد اشیاء استفاده میشوند و اعضای کلاس (مانند ویژگیها و متدها) را در بر میگیرند.
ویژگیهای کلاس
public Product Product { get; set; }
public long ProductId { get; set; }
public int WarrantyPeriod { get; set; }
}
}
public Product Product { get; set; }:
این ویژگی یک رابطه ناوبری (navigation property) برای موجودیت Product است. این ویژگی به شما امکان میدهد تا مستقیماً به شیء Product مرتبط با این Warranty دسترسی داشته باشید. این رابطه به شما امکان میدهد تا اطلاعات محصول را از طریق تضمین (گارانتی) مشاهده کنید.
public long ProductId { get; set; }:
این ویژگی یک کلید خارجی (ProductId) است که به محصول مرتبط با این گارانتی اشاره میکند. نوع داده آن long است و ارتباط بین Warranty و Product را برقرار میکند.
public int WarrantyPeriod { get; set; }:
این ویژگی مدت زمان گارانتی (WarrantyPeriod) را نگه میدارد. نوع داده آن int است و بیانگر تعداد ماهها یا سالهای گارانتی محصول است.
نتیجهگیری
این کلاس Warranty نمایانگر یک مدل دادهای برای گارانتی محصول است که شامل ویژگیهایی مانند محصول مرتبط، شناسه محصول و مدت زمان گارانتی است. این مدل برای استفاده در Entity Framework Core طراحی شده است و به شما امکان میدهد تا اطلاعات گارانتی محصولات را به صورت شیءگرا در کد خود مدیریت کنید و با پایگاه داده تعامل داشته باشید.
بیایید به طور جامع تمامی این کدها را با هم بررسی کنیم و هر بخش از آنها را توضیح دهیم تا درک بهتری از ساختار و روابط بین این موجودیتها (Entities) داشته باشیم.
1. کد Customer
namespace WebApplication5.Models.Entities
{
public class Customer
{
public long Id { get; set; }
public string UserName { get; set; }
public string Password { get; set; }
public string Name { get; set; }
public virtual ICollection<Order> Orders { get; set; }
}
}
ویژگیها: Id (شناسه مشتری)، UserName (نام کاربری)، Password (رمز عبور)، Name (نام کامل).
رابطه: Orders یک مجموعه از Order که این مشتری انجام داده است.
2. کد Order
namespace WebApplication5.Models.Entities
{
public class Order
{
public long Id { get; set; }
public DateTime CraetDate { get; set; }
public string Address { get; set; }
public virtual Customer Customer { get; set; }
public long CustomerId { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
}
}
ویژگیها: Id (شناسه سفارش)، CraetDate (تاریخ ایجاد سفارش)، Address (آدرس مشتری).
رابطهها:
Customer، مرجعی به مشتری که سفارش را ثبت کرده است.
CustomerId، کلید خارجی که به مشتری اشاره میکند.
OrderDetils، مجموعهای از جزئیات سفارش که به این سفارش تعلق دارد.
3. کد OrderDetil
namespace WebApplication5.Models.Entities
{
public class OrderDetil
{
public long Id { get; set; }
public int Count { get; set; }
public virtual Order Order { get; set; }
public long OrderId { get; set; }
public virtual Product Product { get; set; }
public long ProductId { get; set; }
}
}
ویژگیها: Id (شناسه جزئیات سفارش)، Count (تعداد محصول).
رابطهها:
Order، مرجعی به سفارش که این جزئیات به آن تعلق دارد.
OrderId، کلید خارجی که به سفارش اشاره میکند.
Product، مرجعی به محصولی که این جزئیات به آن تعلق دارد.
ProductId، کلید خارجی که به محصول اشاره میکند.
4. کد Product
namespace WebApplication5.Models.Entities
{
public class Product
{
internal object warranty;
public long Id { get; set; }
public string Images { get; set; }
public string Name { get; set; }
public string Brand { get; set; }
public int Price { get; set; }
public float Ram { get; set; }
public OStype OS { get; set; }
public string Network { get; set; }
public int Inventory { get; set; }
public virtual ICollection<OrderDetil> OrderDetils { get; set; }
public Warranty Warranty { get; set; }
}
public enum OStype
{
IOS = 0,
Androide = 1,
WindowsPhone = 2
}
}
ویژگیها: Id (شناسه محصول)، Images (تصاویر محصول)، Name (نام محصول)، Brand (برند محصول)، Price (قیمت محصول)، Ram (حافظه رم)، OS (سیستم عامل)، Network (نوع شبکه)، Inventory (موجودی).
رابطهها:
OrderDetils، مجموعهای از جزئیات سفارش که به این محصول تعلق دارد.
Warranty، مرجعی به گارانتی محصول.
5. کد Warranty
namespace WebApplication5.Models.Entities
{
public class Warranty
{
public Product Product { get; set; }
public long ProductId { get; set; }
public int WarrantyPeriod { get; set; }
}
}
ویژگیها: Product (مرجعی به محصول مرتبط)، ProductId (کلید خارجی که به محصول اشاره میکند)، WarrantyPeriod (مدت زمان گارانتی).
6. کد DatabaseContext
using Microsoft.EntityFrameworkCore;
using WebApplication5.Models.Entities;
namespace WebApplication5.Models.Context
{
public class DatabaseContext : DbContext
{
public DatabaseContext()
{
}
public DbSet<Customer> Customers { get; set; }
public DbSet<Product> Products { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder.UseSqlServer(@"Data Source=DESKTOP-3PDBPI3\SQLEXPRESS; Initial Catalog=StoreEf; Integrated Security=True; TrustServerCertificate=True;");
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Warranty>().HasKey(p => p.ProductId);
modelBuilder.Entity<Product>().HasOne(p => p.Warranty).WithOne(p => p.Product).HasForeignKey<Warranty>(p => p.ProductId);
modelBuilder.Entity<Customer>().Property(e => e.Name).HasColumnName("FullName").HasColumnType("nvarchar(50)");
}
}
}
ویژگیها:
Customers، مجموعهای از مشتریان.
Products، مجموعهای از محصولات.
OnConfiguring: پیکربندی اتصال به پایگاه داده SQL Server.
OnModelCreating: تنظیم مدلها و روابط بین موجودیتها.
نتیجهگیری
این مجموعه کدها نشاندهندهی مدلسازی دادهها با استفاده از Entity Framework Core است که شامل کلاسهای Customer، Order، OrderDetil، Product و Warranty میباشد. همچنین شامل یک کلاس DatabaseContext است که وظیفه مدیریت اتصال به پایگاه داده و پیکربندی مدلها را بر عهده دارد. این ساختار به شما امکان میدهد تا به صورت شیءگرا با پایگاه داده تعامل کنید و دادهها را مدیریت کنید.
و در آخر نتیجه کار
در پک منیجر Add-Migration InitialCompelet
را اضافه می کنید تا Migration ساخته شود و Update-Database
را هم می زنیم تا اتصال در دیتابیس بر قرار می شود و جدول ها ایجاد شوند
WebApplication5.zip
حجم:
16.6M
پروژه asp.net core mvc اتصال به دیتابیس و ایجاد جدول ها
DbContext و الگوهای Repository و Unit of Work
این DbContext در Entity Framework Core به خودی خود یک پیادهسازی از الگوی Unit of Work است. همچنین، DbSetهای آن نقش مخزن (Repository) را ایفا میکنند. بنابراین، بسیاری از توسعهدهندگان بر این باورند که افزودن لایههای اضافی برای Repository و Unit of Work بر روی DbContext غیر ضروری و غیر کاربردی است و میتواند به عنوان آنتیپترن شناخته شود.
دلایل استفاده مستقیم از DbContext:
- سادگی و کاهش پیچیدگی:
استفاده مستقیم از DbContext باعث کاهش پیچیدگی و نگهداری کد میشود. نیاز نیست که لایههای اضافی Repository و Unit of Work را مدیریت کنید.
- کاهش کد اضافی:
افزودن لایههای اضافی Repository و Unit of Work معمولاً به نوشتن کد تکراری و اضافی منجر میشود که ممکن است به پیچیدگی بیشتر و نگهداری سختتر بیانجامد.
- پشتیبانی کامل از EF Core:
در DbContext از تمامی قابلیتها و ویژگیهای EF Core به طور کامل پشتیبانی میکند. استفاده مستقیم از آن به شما امکان میدهد تا از تمام قابلیتها و انعطافپذیری EF Core بهرهمند شوید.
مثال ساده از استفاده مستقیم DbContext:
در اینجا یک نمونه ساده از استفاده مستقیم DbContext در کنترلر آورده شده است:
public class CustomersController : Controller
{
private readonly DatabaseContext _context;
public CustomersController(DatabaseContext context)
{
_context = context;
}
public async Task<IActionResult> Index()
{
var customers = await _context.Customers.ToListAsync();
return View(customers);
}
public IActionResult Create()
{
return View();
}
[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(Customer customer)
{
if (ModelState.IsValid)
{
_context.Add(customer);
await _context.SaveChangesAsync();
return RedirectToAction(nameof(Index));
}
return View(customer);
}
}
در این کد، مستقیماً از DbContext استفاده میکنیم تا دادهها را از پایگاه داده دریافت کرده و عملیات CRUD را انجام دهیم.
آنتیپترن بودن افزودن لایه Repository و Unit of Work:
افزودن لایههای Repository و Unit of Work به عنوان آنتیپترن شناخته میشود زیرا:
- افزایش پیچیدگی بدون افزودن ارزش واقعی: با توجه به این که DbContext خود یک پیادهسازی از Unit of Work و Repository است، افزودن لایههای اضافی بدون افزودن ارزش واقعی به کد، تنها پیچیدگی را افزایش میدهد.
- کاهش عملکرد و بهرهوری: لایههای اضافی میتوانند باعث کاهش عملکرد و بهرهوری شوند زیرا به کد اضافی و هزینههای اضافی نیاز دارند.
نتیجهگیری:
استفاده مستقیم از DbContext به عنوان واحد کاری (Unit of Work) و مخزن (Repository) معمولاً به عنوان بهترین عمل شناخته میشود و از افزودن لایههای اضافی خودداری میشود. این رویکرد نه تنها پیچیدگی را کاهش میدهد بلکه از تمام قابلیتها و امکانات EF Core بهرهمند میشود. البته، بسته به نیازهای خاص پروژه شما، ممکن است موارد استثنایی وجود داشته باشد.