Razor C#（開發者如何理解它）

先決條件

在我們進入 Razor 的世界之前，請確保您已安裝下列軟體：

1. .NET Core SDK 2.Visual Studio

這些都是必要的，因為它們提供了 Razor View Engine 和本教程要使用的專案範本。 此外，它們可以在多種作業系統上運作，這意味著無論您使用的是 Windows、Linux 或 macOS，都可以跟隨操作。

步驟 1 建立新的 Razor Pages 專案

開啟 Microsoft Visual Studio 並遵循下列步驟：

1.按一下"檔案">"新增">"專案"。 2.在專案範本選擇畫面中，選擇"Blazor Server App"。

![Razor C# (How It Works For Developers) 圖 1](/static-assets/pdf/blog/razor-csharp/razor-csharp-1.webp)

3.將專案命名為"IronPDFExample"，然後按一下"建立"。

![Razor C# (How It Works For Developers) 圖 2](/static-assets/pdf/blog/razor-csharp/razor-csharp-2.webp)

4.從下拉式選單中選擇".NET 7.0"或更新版本。

![Razor C# (How It Works For Developers) 圖 3](/static-assets/pdf/blog/razor-csharp/razor-csharp-3.webp)

您現在有一個新的 Razor Pages 專案。

瞭解 Razor 語法和檔案

Razor 檔案使用 .cshtml 檔案副檔名，結合 C# (因此使用 'cs')與 HTML。 如果我們使用 Visual Basic，則檔案副檔名將變更為 .vbhtml 。

在您的解決方案總管中，找到並開啟名為 "Index.cshtml" 的 .cshtml 副檔名。 在這裡您會看到 HTML 程式碼和 C# 程式碼的結合。 Razor Parser 讓此混音成為可能。

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

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

使用 Razor 標記來製作動態內容

Razor Markup 允許我們在 HTML 標記中插入伺服器端程式碼。我們可以使用各種代碼結構，如代碼區、內嵌表達式和 HTML 編碼表達式。

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

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

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

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

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

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

瞭解標籤輔助工具

ASP.NET MVC 中的標籤輔助程式可讓伺服器端程式碼在 Razor 檔案中建立並呈現 HTML 元素。 它們有點像 HTML 幫手，但語法更像 HTML。 他們會將您 Razor 視圖中類似 HTML 的元素轉換成 HTML 標記，傳送到客戶端的瀏覽器。 請參考以下錨點標籤輔助程式 (anchor Tag Helper) 的程式碼範例：

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

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

處理使用者互動

Razor Pages 使用處理程式方法來管理使用者互動。 例如，為了處理表單提交，我們可以在 Razor Page 對應的 Page Model 檔案中建立一個名為 OnPostAsync 的方法。

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

Razor中的評論

Razor 也支援 C# 風格的註解。 請記住，Razor 的註解是伺服器端，意即不會傳送到瀏覽器。 它們是這樣的

@* This is a Razor comment *@

@* This is a Razor comment *@

這是一個多行評論：

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

Razor 視圖和頁面可以包含 HTML 註解。 這些註解在傳送到瀏覽器的 HTML 輸出中是可見的。

<!-- This is an HTML comment -->

<!-- This is an HTML comment -->

將模型傳送至 Razor 頁面。

Razor 可讓您從伺服器傳送模型到頁面。 @model 指令用來指定傳送的物件類型。 如以下範例所示，可在 Razor 頁面中存取此模型屬性：

@page
@model ExampleModel

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

@page
@model ExampleModel

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

在 Razor 中使用 IronPDF 生成 PDF.

Discover IronPDF for .NET是一個廣受歡迎的函式庫，可讓開發人員在 .NET 中從 HTML、圖片甚至現有的網頁產生 PDF。 它是建立報告、發票以及任何其他需要標準列印格式的文件的絕佳工具。 IronPDF for .NET 可在 ASP.NET MVC 和 ASP.NET Razor Pages 框架內完美運作。

Install-Package IronPdf

@using IronPdf;

@using IronPdf;

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

結論

您已成功地學習了 Razor C# 的基本知識，並發現如何整合 IronPDF 以在您的應用程式中產生 PDF 檔案。 您首先在 Visual Studio 中建立一個新專案，然後學習如何使用 Razor 語法建立動態網頁。 您還探討了如何使用 IronPDF 從 HTML 程式碼生成 PDF，甚至是完整的 Razor View。

現在，當您繼續建立更先進的應用程式時，您可以充分利用 IronPDF 提供的強大功能。 您可以 免費試用 IronPDF，如果您覺得有價值，可以購買適合您需求的授權。