Razor C#（开发者如何使用）

前提条件

在我们深入 Razor 的世界之前，请确保您已安装以下内容：

1. .NET Core SDK
2. Visual Studio

这些是必需的，因为它们提供了 Razor 视图引擎和我们将在本教程中使用的项目模板。 此外，它们可以在多个操作系统上运行，这意味着无论您使用 Windows、Linux 或 macOS，您都可以跟随操作。

步骤 1 创建新 Razor Pages 项目

打开 Microsoft Visual Studio 并按照以下步骤操作：

1. 点击"文件"> "新建"> "项目"。

2. 在项目模板选择屏幕中，选择"Blazor 服务器应用"。

   

3. 将您的项目命名为"IronPDFExample"，然后点击"创建"。

   

4. 从下拉菜单中选择".NET 7.0"或更高版本。

   

您现在有了一个新的 Razor Pages 项目。

了解 Razor 语法和文件

Razor文件使用.cshtml文件扩展名，将C#（因此有'cs'）与HTML结合。 如果我们使用Visual Basic，文件扩展名将改为.vbhtml。

在您的解决方案资源管理器中，找到并打开名为"Index.cshtml"的.cshtml扩展文件。 在这里您将看到 HTML 代码和 C# 代码的结合。 这种混合由 Razor 解析器实现。

<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的对应页面模型文件中创建一个名为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>

用 Razor 生成 PDF 文档使用 IronPDF

探索 IronPDF for .NET 是一个流行的库，允许开发人员在 .NET 中从 HTML、图片甚至现有网页生成 PDFs。 这是一个创建报告、发票以及任何需要标准打印格式的文档的绝佳工具。 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，如果您认为它有价值，可以购买适合您需求的许可证。