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

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 باشد. یعنی حرف اول بزرگ باشد.