.NET Guidebook

Web Development

.NET Razor Pages

Using Razor Pages

.NET Razor Pages simplify web apps with page-based routing.

Introduction to Razor Pages

Razor Pages in .NET Core are a page-based programming model that simplifies the building of web applications. They provide a more organized approach by using a file-based routing mechanism, where each page is represented by a pair of files: a Razor Page and a Page Model. This model allows developers to focus on building UI logic and simplifies the management of code-behind files.

Basic Structure of a Razor Page

Each Razor Page consists of two main components:

  • Razor Page (.cshtml): Contains the HTML markup and Razor syntax for rendering UI content.
  • Page Model (.cshtml.cs): Contains the server-side logic and methods that handle page requests and actions.

Creating a Razor Page

To create a Razor Page, follow these simple steps:

  1. Right-click on the Pages folder in your project.
  2. Select Add > New Item.
  3. Choose Razor Page from the list of templates.
  4. Provide a name for your Razor Page and click Add.

Understanding Page Models

The Page Model in Razor Pages serves as the code-behind file that supports the Razor Page. It is where you define properties, methods, and event handlers that are used by the Razor Page.

Here's a basic example of a Page Model:

Handling Requests with Razor Pages

Razor Pages make handling HTTP requests straightforward. The OnGet, OnPost, and other handler methods are automatically bound to their respective HTTP verbs. For instance, when a GET request is made to a page, the OnGet method is invoked.

Benefits of Using Razor Pages

Razor Pages offer several advantages:

  • Simplicity: Page-based routing eliminates the need for complex controller logic.
  • Separation of Concerns: Keeps UI and business logic separate, improving maintainability.
  • Convention over Configuration: Reduces boilerplate code by using conventions to handle common scenarios.

Web Development

Next
MVC