Razor C# (Como funciona para desenvolvedores)

Pré-requisitos

Antes de mergulharmos no mundo do Razor, certifique-se de ter os seguintes softwares instalados:

1. SDK do .NET Core
2. Visual Studio

Esses arquivos são necessários, pois fornecem o mecanismo Razor View e os modelos de projeto que usaremos neste tutorial. Além disso, elas podem funcionar em vários sistemas operacionais, o que significa que você pode acompanhar independentemente de estar usando Windows, Linux ou macOS.

Passo 1: Criando um novo projeto do Razor Pages

Abra o Microsoft Visual Studio e siga estes passos:

1. Clique em "Arquivo" > "Novo" > "Projeto".

2. Na tela de seleção do modelo de projeto, escolha "Aplicativo Blazor Server".

   

3. Dê o nome de "IronPDFExample" ao seu projeto e clique em "Criar".

   

4. Selecione ".NET 7.0" ou posterior nas listas suspensas.

   

Você agora tem um novo projeto do Razor Pages.

Entendendo a sintaxe e os arquivos do Razor

Os arquivos Razor usam a extensão de arquivo .cshtml, combinando C# (daí o 'cs') com HTML. Se estivéssemos usando Visual Basic, a extensão do arquivo mudaria para .vbhtml.

No seu Explorador de Soluções, localize e abra o arquivo com extensão .cshtml chamado "Index.cshtml". É aqui que você verá uma combinação de código HTML e código C#. Essa mistura é possível graças ao Razor Parser.

<p>The current time is @DateTime.Now</p>

<p>The current time is @DateTime.Now</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> The current time is @DateTime.Now</p>

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
</div>

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
</div>

page model ReadOnly Property () As IndexModel
	ViewData("Title") = "Home page"
End Property

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<div class="text-center"> <h1 class="display-4"> Welcome</h1> <p> Learn about <a href="https://docs.microsoft.com/aspnet/core"> building Web apps @with ASP.NET Core</a>.</p> </div>

Utilizando Razor Markup para conteúdo dinâmico

O Razor Markup permite inserir código do lado do servidor em nossa marcação HTML. Podemos usar várias construções de código, como blocos de código, expressões embutidas e expressões codificadas em HTML.

<p>Hello, my name is @Model.Name</p>

<p>Hello, my name is @Model.Name</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> Hello, my name is @Model.Name</p>

@{
    var name = "IronPDF";
}
<p>Hello, my name is @name</p>

@{
    var name = "IronPDF";
}
<p>Hello, my name is @name</p>

@
If True Then
	Dim name = "IronPDF"
End If
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> Hello, my name is @name</p>

@{
    var count = 5;
}

@if (count > 3)
{
    <p>The count is greater than 3.</p>
}

@{
    var count = 5;
}

@if (count > 3)
{
    <p>The count is greater than 3.</p>
}

@
If True Then
	Dim count = 5
End If

'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'@if(count > 3)
'{
'	<p> The count is greater than 3.</p>
'}

@{
    var fileFormat = "PDF";
    var message = "";

    switch (fileFormat) 
    {
        case "PDF":
            message = "You selected PDF.";
            break;
        default:
            message = "Invalid selection.";
            break;
    }
}

<p>@message</p>

@{
    var fileFormat = "PDF";
    var message = "";

    switch (fileFormat) 
    {
        case "PDF":
            message = "You selected PDF.";
            break;
        default:
            message = "Invalid selection.";
            break;
    }
}

<p>@message</p>

@
If True Then
	Dim fileFormat = "PDF"
	Dim message = ""

	Select Case fileFormat
		Case "PDF"
			message = "You selected PDF."
		Case Else
			message = "Invalid selection."
	End Select
End If

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> @message</p>

<p>@("Hello World")</p>

<p>@("Hello World")</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> @("Hello World")</p>

@{
    var names = new List<string> { "John", "Doe", "Smith" };
}

@foreach (var name in names)
{
    <p>@name</p>
}

@{
    var names = new List<string> { "John", "Doe", "Smith" };
}

@foreach (var name in names)
{
    <p>@name</p>
}

@
If True Then
	Dim names = New List(Of String) From {"John", "Doe", "Smith"}
End If

'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'@foreach(var name in names)
'{
'	<p> @name</p>
'}

Entendendo as Tag Helpers

Os Tag Helpers no ASP.NET MVC permitem que o código do lado do servidor crie e renderize elementos HTML em arquivos Razor . São um pouco como auxiliares HTML, mas têm uma sintaxe mais parecida com a do HTML. Eles transformam elementos semelhantes a HTML em suas visualizações Razor na marcação HTML enviada ao navegador do cliente. Considere o seguinte exemplo de código de um auxiliar de tag de âncora:

<a asp-controller="Home" asp-action="Index">Home</a>

<a asp-controller="Home" asp-action="Index">Home</a>

Gerenciando a interação do usuário

As Razor Pages utilizam métodos de tratamento para gerenciar as interações do usuário. Por exemplo, para lidar com o envio de formulários, podemos criar um método chamado OnPostAsync no arquivo Page Model correspondente da nossa Razor Page.

public async Task<IActionResult> OnPostAsync()
{
    if (!ModelState.IsValid)
    {
        return Page();
    }

    // Perform some operation here

    return RedirectToPage("./Index");
}

public async Task<IActionResult> OnPostAsync()
{
    if (!ModelState.IsValid)
    {
        return Page();
    }

    // Perform some operation here

    return RedirectToPage("./Index");
}

Public Async Function OnPostAsync() As Task(Of IActionResult)
	If Not ModelState.IsValid Then
		Return Page()
	End If

	' Perform some operation here

	Return RedirectToPage("./Index")
End Function

Comentários em Razor

O Razor também suporta comentários no estilo C#. Lembre-se, os comentários Razor são processados ​​no servidor, ou seja, não são enviados para o navegador. Eles têm esta aparência:

@* This is a Razor comment *@

@* This is a Razor comment *@

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'@* This is a Razor comment *@

E este é um comentário com várias linhas:

@*
    This is a multi-line Razor comment.
    It's useful when you have a lot to say.
*@

@*
    This is a multi-line Razor comment.
    It's useful when you have a lot to say.
*@

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'@* This is a multi-line Razor comment.It's useful @when you have a lot @to say. *@

As visualizações e páginas do Razor podem incluir comentários HTML. Esses comentários ficam visíveis na saída HTML enviada ao navegador.

Passando modelos para uma página Razor

O Razor permite que você passe modelos do servidor para a página. A diretiva @model é usada para especificar o tipo de objeto que está sendo passado. Essa propriedade do modelo pode ser acessada na página Razor , como mostrado no exemplo abaixo:

@page
@model ExampleModel

<h2>@Model.Title</h2>
<p>@Model.Description</p>

@page
@model ExampleModel

<h2>@Model.Title</h2>
<p>@Model.Description</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'@page @model ExampleModel <h2> @Model.Title</h2> <p> @Model.Description</p>

Gerando PDFs com IronPDF no Razor

Descubra o IronPDF for .NET , uma biblioteca popular que permite aos desenvolvedores gerar PDFs a partir de HTML , imagens e até mesmo páginas da web existentes em .NET. É uma excelente ferramenta para criar relatórios, faturas e qualquer outro documento que exija um formato de impressão padrão. O IronPDF funciona perfeitamente dentro dos frameworks ASP.NET MVC e ASP.NET Razor Pages.

Install-Package IronPdf

@using IronPdf;

@using IronPdf;

Dim IronPdf As [using]

@page "/pdf"
@using IronPdf;
@inject IJSRuntime JS

<PageTitle>Create PDF</PageTitle>

<h1>Create PDF</h1>

<div class="form-outline">
    <button class="btn btn-primary mt-3" @onclick="CreatePDF">Create PDF</button>
</div>

@code {
    private string htmlString { get; set; }

    private async Task CreatePDF()
    {
        var Renderer = new IronPdf.ChromePdfRenderer();
        Renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A2;

        var doc = Renderer.RenderUrlAsPdf("https://ironpdf.com/");

        using var Content = new DotNetStreamReference(stream: doc.Stream);

        await JS.InvokeVoidAsync("SubmitHTML", "ironpdf.pdf", Content);
    }
}

Conclusão

Você aprendeu com sucesso os conceitos básicos de Razor C# e descobriu como integrar o IronPDF para gerar arquivos PDF em seu aplicativo. Você começou criando um novo projeto no Visual Studio e depois aprendeu a usar a sintaxe Razor para criar páginas web dinâmicas. Você também explorou como o IronPDF pode ser usado para gerar PDFs a partir de código HTML e até mesmo criar Views Razor completas.

Agora, à medida que você continua a desenvolver aplicações mais avançadas, pode aproveitar os poderosos recursos oferecidos pelo IronPDF. Você pode experimentar o IronPDF gratuitamente e, se achar útil, pode adquirir uma licença adequada às suas necessidades.