ایتا - پروژه ASP.Net Core MVC (وب و سی شارپ)

کلمه Validation به معنای اعتبارسنجی داده‌هاست که کمک می‌کند تا ورودی‌های کاربر قبل از پردازش یا ذخی

در Asp.Net Core MVC، می‌توانید برای نمایش خطاهای سفارشی یک ویو خاص ایجاد کنید. این ویو می‌تواند برای نمایش پیام‌های خطا و اطلاعات مفید به کاربر استفاده شود. معمولاً، یک ویو خطا به نام Error.cshtml ایجاد می‌شود و در پوشه Views/Shared قرار می‌گیرد.

مثال:
ایجاد فایل Error.cshtml در مسیر Views/Shared:


@model Microsoft.AspNetCore.Mvc.RazorPages.PageModel

<!DOCTYPE html>
<html>
<head>
    <title>خطا رخ داده است</title>
</head>
<body>
    <h1>متاسفیم، یک خطا رخ داده است.</h1>
    <p>لطفاً مجدداً تلاش کنید یا با پشتیبانی تماس بگیرید.</p>
</body>
</html>
پیکربندی Middleware برای استفاده از این ویو: در فایل Startup.cs، در متد Configure، خطای عمومی را به این ویو هدایت کنید:


public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();
    app.UseRouting();
    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}
افزودن اکشن Error به کنترلر Home:


public class HomeController : Controller
{
    public IActionResult Error()
    {
        return View();
    }
}
با این کار، هنگامی که یک خطا در برنامه رخ دهد، کاربر به ویوی Error.cshtml هدایت می‌شود و پیام‌های خطا نمایش داده می‌شود.

این کار اطمینان می‌دهد که کاربران با یک صفحه خطای دوستانه و واضح برخورد می‌کنند.

1 مشاهده09:51

پروژه ASP.Net Core MVC (وب و سی شارپ)

در Asp.Net Core MVC، می‌توانید برای نمایش خطاهای سفارشی یک ویو خاص ایجاد کنید. این ویو می‌تواند برای

اگر فایل Startup.cs را در پروژه‌تان ندارید، احتمالاً از یک نوع پروژه متفاوتی استفاده می‌کنید که تنظیمات آن متفاوت است. برای پیکربندی خطا در Asp.Net Core، می‌توانید به جای استفاده از Startup.cs از فایل Program.cs استفاده کنید.

نمونه پیکربندی خطا در Program.cs:

var builder = WebApplication.CreateBuilder(args);

// سایر تنظیمات و سرویس‌ها

var app = builder.Build();

// پیکربندی برای مدیریت خطاها
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();
اضافه کردن اکشن Error به کنترلر Home:

public class HomeController : Controller
{
    public IActionResult Error()
    {
        return View();
    }
}
ایجاد فایل Error.cshtml در مسیر Views/Shared:

@model Microsoft.AspNetCore.Mvc.RazorPages.PageModel

<!DOCTYPE html>
<html>
<head>
    <title>خطا رخ داده است</title>
</head>
<body>
    <h1>متاسفیم، یک خطا رخ داده است.</h1>
    <p>لطفاً مجدداً تلاش کنید یا با پشتیبانی تماس بگیرید.</p>
</body>
</html>
این کد تضمین می‌کند که اگر یک خطا در محیط غیرتوسعه رخ دهد، کاربر به ویوی Error.cshtml هدایت می‌شود و پیام‌های خطا نمایش داده می‌شوند.

1 مشاهده10:05

پروژه ASP.Net Core MVC (وب و سی شارپ)

Routing
 در Asp.Net Core MVC فرایندی است که در آن درخواست‌های HTTP به اکشن‌های مناسب در کنترلرهای مربوطه هدایت می‌شوند. این فرایند به شما کمک می‌کند تا URLها را با منطق کسب‌وکار و محتوای اپلیکیشن خود تطبیق دهید.
اجزای اصلی Routing:
Endpoints:
 نقاط پایانی که توسط اکشن‌های کنترلر یا ریزکنترل‌ها (Razor Pages) مشخص می‌شوند.

Routes:
 الگوهایی که برای تطبیق URLها با اکشن‌های کنترلر استفاده می‌شوند.

Route Constraints:
 محدودیت‌هایی که برای محدود کردن URLها به الگوهای خاص اعمال می‌شوند.

انواع Routing:
1- Convention-based Routing (Routing بر اساس قواعد):

این نوع Routing بر اساس الگوهای از پیش تعریف شده انجام می‌شود. مثلاً:
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});
در اینجا، الگوی پیش‌فرض شامل کنترلر، اکشن و پارامتر اختیاری id است.

2- Attribute-based Routing (Routing بر اساس صفات):

با استفاده از Attributeهای مشخصی، مسیرهای URL در اکشن‌ها تعریف می‌شوند. مثلاً:
[Route("products/{id}")]
public IActionResult GetProduct(int id)
{
    // منطق برای دریافت محصول با استفاده از شناسه
    return View();
}
این روش بیشتر برای اکشن‌ها و کنترلرهایی که نیاز به مسیرهای پیچیده دارند استفاده می‌شود.

تنظیمات Routing در فایل Program.cs:
برای پیکربندی Routing، شما می‌توانید از تنظیمات در فایل Program.cs استفاده کنید:
var builder = WebApplication.CreateBuilder(args);

// سایر تنظیمات و سرویس‌ها

var app = builder.Build();

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});

app.Run();
با این تنظیمات، شما می‌توانید URLهای مورد نظر خود را به اکشن‌های کنترلرها هدایت کنید و اپلیکیشنی با ساختار URLهای منظم و مدیریت‌پذیر ایجاد کنید.

1 مشاهده12:38

پروژه ASP.Net Core MVC (وب و سی شارپ)

اکشن پیش‌فرض (Default Action) به اکشنی گفته می‌شود که وقتی هیچ اکشنی در URL مشخص نشده باشد، فراخوانی می‌شود. در Asp.Net Core MVC، شما می‌توانید اکشن پیش‌فرض را با استفاده از تنظیمات Routing پیکربندی کنید.

برای مثال، در تنظیمات Routing پیش‌فرض که در Program.cs قرار می‌گیرد:
var builder = WebApplication.CreateBuilder(args);

// سایر تنظیمات و سرویس‌ها

var app = builder.Build();

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});

app.Run();
در اینجا، اگر هیچ کنترلی و اکشنی در URL مشخص نشده باشد، به طور پیش‌فرض کنترلر Home و اکشن Index فراخوانی خواهند شد.

یعنی اگر کاربر به / مراجعه کند، به طور خودکار به /Home/Index هدایت خواهد شد.

1 مشاهده12:49

پروژه ASP.Net Core MVC (وب و سی شارپ)

تغییر URLها می‌تواند دلایل مختلفی داشته باشد:

 (بهینه‌سازی برای موتورهای جستجو)SEO :
  ‎‏‍⁩   ⁦URLهای
 تمیز و قابل خواندن برای انسان‌ها و موتورهای جستجو بهتر هستند و می‌توانند رتبه سایت شما را در نتایج جستجو بهبود دهند.

امنیت: بعضی اوقات، تغییر URLها می‌تواند به افزایش امنیت کمک کند. مثلاً می‌توانید URLهایی که شامل پارامترهای حساس هستند را پنهان کنید.

خوانایی و دسترسی‌پذیری: URLهایی که توصیفی هستند، برای کاربران و توسعه‌دهندگان قابل فهم‌تر و دسترسی‌پذیرتر هستند.

مدیریت مسیرها: زمانی که مسیرهای جدیدی به برنامه اضافه می‌کنید یا معماری برنامه تغییر می‌کند، نیاز به تغییر URLها به وجود می‌آید.

جلوگیری از تکرار: برای جلوگیری از تکرار URLهای مشابه و اطمینان از اینکه هر مسیر یکتا است.

این تغییرات می‌توانند تجربه کاربری بهتری ارائه دهند و برنامه را مدیریت‌پذیرتر کنند.

1 مشاهده12:55

پروژه ASP.Net Core MVC (وب و سی شارپ)

بیایید یک صفحه تماس با ما را با استفاده از Asp.Net Core MVC پیاده‌سازی کنیم.

1. مدل (ContactModel.cs)
ابتدا یک مدل برای دریافت اطلاعات تماس ایجاد می‌کنیم:

public class ContactModel
{
    [Required]
    public string Name { get; set; }

    [Required, EmailAddress]
    public string Email { get; set; }

    [Required]
    public string Message { get; set; }
}
2. کنترلر (ContactController.cs)
سپس یک کنترلر برای مدیریت درخواست‌های مربوط به تماس ایجاد می‌کنیم:

public class ContactController : Controller
{
    [HttpGet]
    public IActionResult Index()
    {
        return View();
    }

    [HttpPost]
    public IActionResult Index(ContactModel model)
    {
        if (ModelState.IsValid)
        {
            // منطق برای ارسال پیام یا ذخیره آن
            TempData["Message"] = "پیام شما با موفقیت ارسال شد!";
            return RedirectToAction("Index");
        }
        return View(model);
    }
}
3. ویو (Index.cshtml)
یک ویو برای نمایش فرم تماس با ما ایجاد می‌کنیم:

@model YourNamespace.Models.ContactModel

<h1>تماس با ما</h1>

@if (TempData["Message"] != null)
{
    <div class="alert alert-success">
        @TempData["Message"]
    </div>
}

<form asp-action="Index" method="post">
    <div>
        <label asp-for="Name"></label>
        <input asp-for="Name" />
        <span asp-validation-for="Name"></span>
    </div>
    <div>
        <label asp-for="Email"></label>
        <input asp-for="Email" />
        <span asp-validation-for="Email"></span>
    </div>
    <div>
        <label asp-for="Message"></label>
        <textarea asp-for="Message"></textarea>
        <span asp-validation-for="Message"></span>
    </div>
    <button type="submit">ارسال</button>
</form>

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}
4. افزودن اسکریپت‌های اعتبارسنجی
در نهایت، اطمینان حاصل کنید که فایل _ValidationScriptsPartial.cshtml شامل اسکریپت‌های اعتبارسنجی است:

<script src="~/lib/jquery/dist/jquery.min.js"></script>
<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
<script src="~/lib/jquery-validation-unobtrusive/dist/jquery.validate.unobtrusive.min.js"></script>
به این ترتیب، یک فرم تماس با ما با اعتبارسنجی سمت کلاینت ایجاد کرده‌ایم که پیام‌های کاربر را دریافت و پردازش می‌کند. 

5. برای پیکربندی URL در فایل Program.cs می‌توانید از تنظیمات MapControllerRoute استفاده کنید. این تنظیمات به شما اجازه می‌دهد تا مسیرها و کنترلرهای خود را تعریف کنید.

مثال پیکربندی URL در Program.cs:

var builder = WebApplication.CreateBuilder(args);

// سایر تنظیمات و سرویس‌ها

var app = builder.Build();

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
    
    // اضافه کردن مسیر تماس با ما
    endpoints.MapControllerRoute(
        name: "contact",
        pattern: "contact-us",
        defaults: new { controller = "Contact", action = "Index" });
});

app.Run();
توضیحات:
MapControllerRoute:
 برای تعریف مسیرها استفاده می‌شود.

name:
 نام مسیر که برای تشخیص آن استفاده می‌شود.

pattern:
 الگوی URL که درخواست‌ها را به کنترلر و اکشن مشخص می‌کند.

defaults:
 مشخص می‌کند که به صورت پیش‌فرض کدام کنترلر و اکشن باید فراخوانی شوند.

در این مثال، یک مسیر جدید به نام contact تعریف شده که زمانی که کاربر به contact-us مراجعه می‌کند، اکشن Index در کنترلر Contact فراخوانی می‌شود.

این کار کمک می‌کند تا URLهای کاربردی و خوانایی داشته باشید که تجربه کاربری بهتری را فراهم می‌کند.

1 مشاهده13:08

پروژه ASP.Net Core MVC (وب و سی شارپ)

ترتیب قرارگیری مسیرها (Routes) در Asp.Net Core MVC بسیار مهم است زیرا فریمورک مسیرها را به ترتیب تعریف‌شده ارزیابی می‌کند و اولین مسیری که با الگوی درخواست مطابقت داشته باشد را انتخاب می‌کند. این یعنی مسیرهای خاص باید قبل از مسیرهای عمومی‌تر تعریف شوند.

مثال:
در فایل Program.cs:
var builder = WebApplication.CreateBuilder(args);

// سایر تنظیمات و سرویس‌ها

var app = builder.Build();

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    // مسیر خاص باید قبل از مسیر عمومی تعریف شود
    endpoints.MapControllerRoute(
        name: "contact",
        pattern: "contact-us",
        defaults: new { controller = "Contact", action = "Index" });
    
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});

app.Run();
توضیحات:
مسیر خاص: مسیر contact-us ابتدا تعریف شده، بنابراین هر درخواستی که به contact-us مراجعه کند، به اکشن Index در کنترلر Contact هدایت می‌شود.

مسیر عمومی: مسیر پیش‌فرض {controller=Home}/{action=Index}/{id?} بعد از مسیر خاص قرار داده شده تا درخواستی که به هیچ‌کدام از مسیرهای خاص مطابقت ندارد، به این مسیر هدایت شود.

این ترتیب اطمینان می‌دهد که مسیرهای خاص‌تر قبل از مسیرهای عمومی‌تر بررسی می‌شوند، و از تصادف در مسیرها و ارسال اشتباه درخواست‌ها جلوگیری می‌کند.

1 مشاهده13:19

پروژه ASP.Net Core MVC (وب و سی شارپ)

علامت سوال ? در مسیرها به معنای اختیاری بودن پارامتر است. یعنی اگر پارامتری مانند id در URL ذکر نشده باشد، اکشن همچنان اجرا می‌شود. این به شما امکان می‌دهد مسیرهای منعطف‌تری داشته باشید.
و اگر علامت سوال را بردارید id اجباری می شود 
مثال:

endpoints.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");
در این مثال، id? نشان می‌دهد که پارامتر id اختیاری است. بنابراین، هر دو URL زیر معتبر هستند و به اکشن Index در کنترلر Home هدایت می‌شوند:

/Home/Index

/Home/Index/123

این ویژگی مفیده برای زمان‌هایی که پارامترها همیشه نیاز نیستند و می‌خواهید مسیرها تمیز و ساده باشند.

1 مشاهده13:27

پروژه ASP.Net Core MVC (وب و سی شارپ)

1 مشاهده13:33

پروژه ASP.Net Core MVC (وب و سی شارپ)

برای مثالی که شامل پارامتر id باشد و خروجی این پارامتر را نمایش دهد، ابتدا یک کنترلر و یک ویو ایجاد می‌کنیم.

کنترلر (ProductsController.cs):
public class ProductsController : Controller
{
    public IActionResult Details(int? id)
    {
        if (id == null)
        {
            return NotFound("ID محصول ارائه نشده است.");
        }

        // منطق برای دریافت محصول با استفاده از ID
        var product = new Product 
        {
            Id = id.Value,
            Name = "Product Name",
            Price = 100
        };

        return View(product);
    }
}
ویو (Details.cshtml):
@model YourNamespace.Models.Product

<h1>جزییات محصول</h1>

@if (Model != null)
{
    <div>
        <p>شناسه: @Model.Id</p>
        <p>نام: @Model.Name</p>
        <p>قیمت: @Model.Price</p>
    </div>
}
else
{
    <p>محصول یافت نشد.</p>
}
تنظیمات در Program.cs:
var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});

app.Run();
توضیحات:
در کنترلر، اکشن Details شناسه id را به عنوان پارامتر دریافت می‌کند. اگر id ارائه نشده باشد، یک پیام خطا نمایش داده می‌شود.

در ویو، مدل Product نمایش داده می‌شود که شامل شناسه، نام و قیمت محصول است.

در Program.cs، مسیر پیش‌فرض شامل پارامتر id? است که اختیاری بودن id را نشان می‌دهد.

با این مثال، اگر به URL /Products/Details/1 مراجعه کنید، جزئیات محصول با id = 1 نمایش داده می‌شود. اگر id ارائه نشده باشد، پیام خطای مناسب نمایش داده خواهد شد.

1 مشاهده13:42

پروژه ASP.Net Core MVC (وب و سی شارپ)

در ASP.NET Core MVC، اعتبارسنجی (Validation) فرآیندی است که در آن داده‌های ورودی بررسی می‌شوند تا اطمینان حاصل شود که مطابق با قوانین و محدودیت‌های خاصی هستند. اعتبارسنجی می‌تواند به صورت سمت سرور و سمت کلاینت انجام شود. اعتبارسنجی سمت کلاینت می‌تواند با استفاده از JavaScript و کتابخانه‌های مرتبط انجام شود، در حالی که اعتبارسنجی سمت سرور با استفاده از Data Annotations و منطق کد در کنترلرها انجام می‌شود.

استفاده از Data Annotations برای اعتبارسنجی:
Data Annotations
می‌توانند در مدل‌ها استفاده شوند تا قوانین اعتبارسنجی را تعریف کنند. این قوانین شامل الزامات پایه‌ای مانند فیلدهای اجباری، طول رشته، محدوده عدد و الگوهای خاص می‌شوند.

مثال:
مدلی با اعتبارسنجی:
public class ContactModel
{
    [Required(ErrorMessage = "لطفا نام خود را وارد کنید")]
    [StringLength(100, ErrorMessage = "نام نباید بیش از 100 کاراکتر باشد")]
    public string Name { get; set; }

    [Required(ErrorMessage = "لطفا ایمیل خود را وارد کنید")]
    [EmailAddress(ErrorMessage = "لطفا یک ایمیل معتبر وارد کنید")]
    public string Email { get; set; }

    [Required(ErrorMessage = "لطفا پیام خود را وارد کنید")]
    public string Message { get; set; }
}
اعمال اعتبارسنجی در ویو:
در ویو می‌توان از Tag Helpers و HTML Helpers برای نمایش پیام‌های خطای اعتبارسنجی استفاده کرد.

ویو (Index.cshtml):
@model YourNamespace.Models.ContactModel

<h1>فرم تماس با ما</h1>

<form asp-action="Index" method="post">
    <div>
        <label asp-for="Name"></label>
        <input asp-for="Name" />
        <span asp-validation-for="Name"></span>
    </div>
    <div>
        <label asp-for="Email"></label>
        <input asp-for="Email" />
        <span asp-validation-for="Email"></span>
    </div>
    <div>
        <label asp-for="Message"></label>
        <textarea asp-for="Message"></textarea>
        <span asp-validation-for="Message"></span>
    </div>
    <button type="submit">ارسال</button>
</form>

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}
اکشن کنترلر:
در کنترلر، می‌توان مدل را دریافت و بررسی کرد که آیا داده‌ها معتبر هستند یا خیر:
public class ContactController : Controller
{
    [HttpPost]
    public IActionResult Index(ContactModel model)
    {
        if (ModelState.IsValid)
        {
            // منطق پردازش پیام
            TempData["Message"] = "پیام شما با موفقیت ارسال شد!";
            return RedirectToAction("Index");
        }
        return View(model);
    }
}
افزودن اسکریپت‌های اعتبارسنجی:
در نهایت، اطمینان حاصل کنید که فایل _ValidationScriptsPartial.cshtml شامل اسکریپت‌های اعتبارسنجی است:
<script src="~/lib/jquery/dist/jquery.min.js"></script>
<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
<script src="~/lib/jquery-validation-unobtrusive/dist/jquery.validate.unobtrusive.min.js"></script>
این فرآیندها کمک می‌کنند تا از ورود داده‌های نادرست جلوگیری شود و تجربه کاربری بهتری فراهم شود.

1 مشاهده06:41

پروژه ASP.Net Core MVC (وب و سی شارپ)

asp-validation-for
 یک Tag Helper در ASP.NET Core است که برای نمایش پیام‌های خطای اعتبارسنجی در کنار کنترل‌های ورودی فرم استفاده می‌شود. این Tag Helper به شما امکان می‌دهد که به راحتی پیام‌های خطای مرتبط با یک فیلد خاص را نشان دهید.

مثال استفاده از asp-validation-for:
<form asp-action="SubmitForm" method="post">
    <div>
        <label asp-for="Name"></label>
        <input asp-for="Name" />
        <span asp-validation-for="Name"></span>
    </div>
    <div>
        <label asp-for="Email"></label>
        <input asp-for="Email" />
        <span asp-validation-for="Email"></span>
    </div>
    <button type="submit">ارسال</button>
</form>
تنظیم رنگ پیام‌های خطا به رنگ قرمز:
برای تنظیم رنگ پیام‌های خطای اعتبارسنجی به رنگ قرمز، می‌توانید CSS سفارشی اضافه کنید. به عنوان مثال:

ایجاد یا اصلاح فایل CSS (مثل site.css):
.field-validation-error {
    color: red;
}
اطمینان از بارگذاری CSS در ویو یا Layout:
<!DOCTYPE html>
<html>
<head>
    <title>@ViewData["Title"] - My Web Application</title>
    <link rel="stylesheet" type="text/css" href="~/css/site.css" />
</head>
<body>
    <header>
        <nav>
            <!-- نوار ناوبری -->
        </nav>
    </header>
    <main>
        @RenderBody()
    </main>
    <footer>
        <!-- فوتر -->
    </footer>
    @RenderSection("Scripts", required: false)
</body>
</html>
نتیجه:
با این کار، پیام‌های خطای اعتبارسنجی که توسط asp-validation-for تولید می‌شوند، به رنگ قرمز نمایش داده خواهند شد و تجربه کاربری بهتری را فراهم می‌کنند.

1 مشاهده06:52

مطالب بعدی

پرسش‌ها

قوانین

داغ‌ترین‌ها

چندسکویی