Razor Page چیست ؟ چطور باید از Razor Page ها استفاده کرد ؟

پاسخ هوش مصنوعی

Razor Page یک الگوی برنامه نویسی در ASP.NET Core است که به توسعه دهندگان این امکان را می دهد تا برنامه های وب را به شیوه ای ساده تر و سازمان یافته تر بسازند. Razor Page ها به جای استفاده از کنترلرها و اکشن ها، بر روی صفحات متمرکز هستند و هر صفحه می تواند هم کد HTML و هم کد C# را در خود داشته باشد. این ویژگی باعث می شود که کد خواناتر و ساختار یافته تر باشد.

برای استفاده از Razor Page ها، شما باید مراحل زیر را دنبال کنید:

1. ایجاد یک پروژه ASP.NET Core:
   - ابتدا یک پروژه جدید با نوع "Web Application" و انتخاب گزینه "Web Application (Model-View-Controller)" ایجاد کنید.

2. افزودن Razor Pages:
   - در پوشه "Pages" یک صفحه جدید با فرمت "نامصفحه.cshtml" (به عنوان مثال: "Index.cshtml") ایجاد کنید.

3. نوشتن کد HTML و C#:
   - در فایل .cshtml، شما می توانید کد HTML خود را به همراه Razor Syntax (مثل @model و @foreach) بنویسید.
   - همچنین می توانید برای هر Razor Page یک فایل "نامصفحه.cshtml.cs" ایجاد کنید که منطق C# شما در آنجا قرار می گیرد.

4. انجام Routing:
   - Razor Pages به طور خودکار به URL صفحه مرتبط می شوند. به عنوان مثال، صفحه "Index.cshtml" به URL اصلی سایت متصل می شود.

5. اجرای پروژه:
   - با اجرای پروژه، می توانید به راحتی صفحات Razor را در مرورگر خود مشاهده کنید.

پاسخ هوش مصنوعی

Razor Page یک ویژگی از ASP.NET Core است که به شما امکان می دهد صفحات وب را به راحتی و به صورت ساختاریافته ایجاد کنید. Razor Page ها به صورت فایل های .cshtml هستند و از Razor syntax برای ترکیب HTML با کد C# استفاده می کنند.

Razor Page به صورت خاص برای ساخت برنامه های وب که نیاز به بارگذاری سریع و پاسخ دهی بالا دارند طراحی شده است. این ویژگی به شما اجازه می دهد که منطق صفحه و نمایش صفحه را در کنار هم در یک فایل قرار دهید، که باعث سادگی و کاهش پیچیدگی کد می شود.

برای استفاده از Razor Page ها در ASP.NET Core، شما به طور کلی مراحل زیر را دنبال می کنید:

1. ایجاد یک پروژه ASP.NET Core:
   از Visual Studio یا CLI برای ایجاد یک پروژه جدید ASP.NET Core استفاده کنید.
   
2. اضافه کردن Razor Page:
   در پوشه "Pages"، یک فایل جدید با پسوند .cshtml ایجاد کنید. این فایل شامل کد HTML و Razor می شود.
   
3. نوشتن کد در فایل Razor Page:
   می توانید منطق پردازش داده ها و کد C# را در کنار HTML بنویسید. برای مثال:
   

<@page>
<h2>عنوان صفحه</h2>
<p>این یک Razor Page است.</p>

@functions {
    public string GetMessage() {
        return "سلام، اینجا Razor Page است!";
    }
}
<p>@GetMessage()</p>

4. کنترل روتینگ:

شما می توانید با استفاده از کنوانسیون ها یا استفاده از ویژگی های روتینگ خاص، مسیرهای مختلف به Razor Page ها را تعریف کنید.

5. اجرای برنامه:

پس از ایجاد صفحه و نوشتن کد، می توانید برنامه خود را اجرا کرده و به آدرس مورد نظر بروید تا صفحه خود را مشاهده کنید.

Razor Page چیست ؟

در تعریف خود مایکروسافت Razor Page ها ابزاری در Asp.net Core هستند که توسط آن ها برنامه نویس می تواند تمامی الگوهای رایج در برنامه نویسی و مرورگر را به راحتی پیاده سازی کند. قابلیت مهم Razor Page ها این می باشد که شما می توانید یک صفحه کامل را تنها در یک فایل با پسوند razor پیاده سازی کنید. یعنی تنها در یک فایل razor می توانید کدهای Html و Css را بنویسید، تمامی رفرنس ها و کتابخانه های مورد نیاز را فراخوانی کنید، مسیر (Route) صفحه را مشخص کنید و تمامی دستورات سی شارپ، توابع، متدها، اینترفیس ها و کلاس ها و ... را هم استفاده کنید.

ساختار یک Razor Page چگونه است ؟

فایل های Razor Page با پسوند razor در ساختار پروژه های Asp.net Core و Blazor قابل مشاهده هستند.

یک razor page از 3 قسمت تشکیل می شود. کدهای زیر مربوط به یک razor page ساده می باشد.

@* Section 1 *@
@page "/counter"

@* Section 2 *@
<h1>Counter</h1>
<p>Current count: @currentCount</p>
<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>

@* Section 3 *@
@code {
    private int currentCount = 0;

    private void IncrementCount()
    {
        currentCount++;
    }
}

• در قسمت اول (Section 1) می توانیم کتابخانه ها، رفرنس ها، مسیرها (Route) یا اگر نیاز به تزریقی (Dependency Injection) وجود دارد را انجام دهیم.
• در قسمت دوم (Section 2) می توانیم UI یا همان طراحی صفحه را انجام دهیم. در این بخش می توان از تگ های Html و Css و یا کلاس های Bootstrap و ... استفاده می شود.
• قسمت سوم (Section 3) هم بخش Code هست که می توانیم منطق این صفحه یا همان کدها و متدها و توابع مورد نیاز را بنویسیم.

یکی از مزیت های اصلی Razor Page ها این می باشد که در یک صفحه (یا یک فایل) همه چیز را می توان در کنار هم قرار داد و نتیجه دلخواه را مشاهده کرد.

نکته : دقت کنید که برای نمایش یک Razor Page به مسیر مشخص شده در بالای صفحه باید توجه کرد و مسیر فیزیکی razor page در پروژه مهم نیست. (فرق بین Razorpage و صفحات cshtml در Blazor چی هست ؟)

چگونه یک Razor Page جدید بسازیم ؟

برای ایجاد یک razor page جدید کافیست روی پوشه Pages در Solution Explorer کلیک راست کنید و از منوی Add گزینه Razor Component را انتخاب کنید.

سپس از فرم Add New Item گزینه Razor Component را انتخاب کنید و یک نام برای Razor Page خود انتخاب کنید. دقت کنید بهتر است نام گذاری صفحات Razor Page به صورت Capital باشد. یعنی حرف اول بزرگ باشد.