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應用"。

   

3. 將您的項目命名為"IronPDFExample"並單擊"創建"。

   

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

   

您現在擁有一個新的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標記允許我們在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標記。 請參考以下錨標籤助手的代碼示例：

<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輸出中可見。

將模型傳遞到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>

使用IronPDF在Razor中生成PDF

了解IronPDF for .NET 是一個受歡迎的程式庫，可以讓開發者從HTML、圖片，甚至現有的.NET網頁中生成PDF。 它是創建報告、發票以及任何需要標準打印格式的文件的極好工具。 IronPDF在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代碼甚至完整的Razor視圖中生成PDF。

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