Razor C# (Wie es für Entwickler funktioniert)

Voraussetzungen

Bevor wir in die Welt von Razor eintauchen, stellen Sie sicher, dass Sie Folgendes installiert haben:

1. .NET Core SDK
2. Visual Studio

Diese sind notwendig, da sie die Razor View Engine und die Projektvorlagen bereitstellen, die wir für dieses Tutorial verwenden werden. Außerdem können sie auf mehreren Betriebssystemen ausgeführt werden, was bedeutet, dass Sie folgen können, egal ob Sie Windows, Linux oder macOS verwenden.

Schritt 1 Erstellen eines neuen Razor Pages-Projekts

Öffne Microsoft Visual Studio und folge diesen Schritten:

1. Klicke auf "Datei" > "Neu" > "Projekt".

2. Wähle im Bildschirm zur Projektvorlagenauswahl "Blazor Server App" aus.

   

3. Benennen Sie Ihr Projekt "IronPDFExample" und klicken Sie auf "Erstellen".

   

4. Wähle ".NET 7.0" oder höher aus den Dropdowns.

   

Du hast jetzt ein neues Razor Pages-Projekt.

Verständnis der Razor-Syntax und Dateien

Razor Dateien verwenden die Dateiendung .cshtml, wodurch C# (daher das 'cs') mit HTML kombiniert wird. Wenn wir Visual Basic verwenden würden, würde sich die Dateierweiterung in .vbhtml ändern.

Suchen und öffnen Sie im Projektmappen-Explorer die Datei mit der Erweiterung .cshtml und dem Namen "Index.cshtml". Hier sehen Sie eine Kombination aus HTML-Code und C#-Code. Diese Mischung wird durch den Razor Parser ermöglicht.

<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>

Verwendung von Razor Markup für dynamische Inhalte

Razor-Markup erlaubt es uns, serverseitigen Code in unser HTML-Markup einzufügen. Wir können verschiedene Codekonstrukte wie Codeblöcke, Inline-Ausdrücke und HTML-kodierte Ausdrücke verwenden.

<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>
'}

Verständnis von Tag-Helfern

Tag-Helper in ASP.NET MVC ermöglichen es serverseitigem Code, HTML-Elemente in Razor-Dateien zu erstellen und zu rendern. Sie ähneln HTML-Helpern, haben jedoch eine HTML-ähnlichere Syntax. Sie verwandeln HTML-ähnliche Elemente in Ihren Razor Views in das HTML-Markup, das an den Client-Browser gesendet wird. Betrachten Sie das folgende Codebeispiel eines Anker-Tag-Helpers:

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

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

Handhabung von Benutzerinteraktion

Razor Pages verwenden Handler-Methoden, um Benutzerinteraktionen zu verwalten. Um beispielsweise die Formularübermittlung zu verarbeiten, können wir in der entsprechenden Seitenmodelldatei unserer Razor Page eine Methode mit dem Namen OnPostAsync erstellen.

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

Kommentare in Razor

Razor unterstützt auch C#-Stil-Kommentare. Denke daran, dass Razor-Kommentare serverseitig sind, das heißt, sie werden nicht an den Browser gesendet. Sie sehen so aus:

@* 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 *@

Und dies ist ein mehrzeiliger Kommentar:

@*
    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. *@

Razor-Ansichten und -Seiten können HTML-Kommentare enthalten. Diese Kommentare sind in der an den Browser gesendeten HTML-Ausgabe sichtbar.

Modelle an eine Razor-Seite weitergeben

Razor erlaubt es Ihnen, Modelle vom Server an die Seite zu übergeben. Die Direktive @model dient zur Angabe des Typs des übergebenen Objekts. Diese Modelleigenschaft kann in der Razor-Seite aufgerufen werden, wie im folgenden Beispiel gezeigt:

@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>

Erzeugen von PDFs mit IronPDF in Razor

IronPDF für .NET ist eine beliebte Bibliothek, die es Entwicklern ermöglicht, PDFs aus HTML, Bildern und sogar bestehenden Webseiten in .NET zu generieren. Es ist ein hervorragendes Werkzeug zum Erstellen von Berichten, Rechnungen und jeder anderen Art von Dokument, in dem ein Standard-Druckformat erforderlich ist. IronPDF funktioniert perfekt innerhalb des ASP.NET MVC und ASP.NET Razor Pages Frameworks.

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);
    }
}

Abschluss

Sie haben erfolgreich die Grundlagen von Razor C# gelernt und entdeckt, wie man IronPDF integriert, um innerhalb Ihrer Anwendung PDF-Dateien zu erstellen. Sie haben damit begonnen, ein neues Projekt in Visual Studio zu erstellen und dann gelernt, wie man die Razor-Syntax verwendet, um dynamische Webseiten zu erstellen. Sie haben auch erkundet, wie IronPDF verwendet werden kann, um PDFs aus HTML-Code und sogar kompletten Razor Views zu generieren.

Nun, da Sie beginnen, anspruchsvollere Anwendungen zu entwickeln, können Sie die leistungsstarken Funktionen nutzen, die IronPDF bietet. Sie können IronPDF kostenlos ausprobieren und wenn Sie es als wertvoll erachten, können Sie eine Lizenz erwerben, die Ihren Bedürfnissen entspricht.