.NET 幫助

Mediatr C#（開發者使用方法）

Q: 如何在.NET應用程式中將HTML轉換為PDF？

IronPDF 允許在 .NET 應用程式中將 HTML 轉換為 PDF。您可以使用 RenderHtmlAsPdf 方法轉換 HTML 字串，或使用 RenderUrlAsPdf 方法轉換 URL，從而確保產生的 PDF 中保留佈局。

更新:7月 28, 2025

MediatR是一個流行的 .NET 函式庫，它實現了中介人模式，讓物件之間可以透過中介人而非直接溝通。此方法對於需要維持元件間低耦合度的應用程式特別有用。在這篇文章中，我們將以 C# 開發為背景，詳細介紹 MediatR，並提供實用範例和指導，說明如何將 MediatR 整合到您的 Web 應用程式專案中。我們也將探討 IronPDF library for PDF functionalities in .NET applications 如何在 ASP.NET Core 專案中整合 PDF 功能。

中介模式與 MediatR 簡介

Mediatr C# (How It Works For Developers)：圖 1 - MediatR 與 Mediator 模式

中介者模式是一種軟體設計模式，可促進物件間的互動，減少物件間的直接依賴，促進鬆散耦合。 MediatR 提供了一個不具雄心壯志的中介實作，在促進物件溝通時著重於簡單與效率。

MediatR 函式庫的核心是請求和多重處理程式的概念。在請求點，一個物件封裝了操作或動作的細節，等待 MediatR 機制處理。每個請求都由相對應的 handler 或 handle 方法處理，其中包含執行請求的業務邏輯。這種結構對於實作命令查詢責任區隔 (CQRS) 模式特別有用，讀取與寫入作業的分離可以使軟體架構更具維護性與擴充性。

使用套件管理員控制台在 .NET Core 專案中安裝 MediatR。

若要開始在 ASP.NET Core 專案中使用 MediatR，您首先需要安裝 MediatR 套件。可透過 Visual Studio 中的套件管理員控制台，使用下列指令完成：

Install-Package MediatR

Mediatr C# (How It Works For Developers)：圖 2 - 安裝 MediatR

安裝套件後，需要將 MediatR 加入 ASP.NET Core 依賴注入容器。這通常會在 Web 應用程式專案的 Program.cs 或 Startup.cs 檔案中完成，視您使用的 ASP.NET Core 版本而定。以下是如何在程式中以最少的 API 展示層來完成。

// Initialize a new web application
var builder = WebApplication.CreateBuilder(args);

// Add MediatR to the service container
builder.Services.AddMediatR(typeof(Program).Assembly);

// Build the web application
var app = builder.Build();

// Initialize a new web application
var builder = WebApplication.CreateBuilder(args);

// Add MediatR to the service container
builder.Services.AddMediatR(typeof(Program).Assembly);

// Build the web application
var app = builder.Build();

$vbLabelText $csharpLabel

在程式類別中，var builder = WebApplication.CreateBuilder(args); 會初始化 Web 應用程式，為 MediatR 整合奠定基礎。

建立您的第一個 MediatR 請求與處理程式

MediatR 請求是代表執行特定作業所需資料的簡單類別。以下是一個請求類的範例，代表一個建立新使用者的指令。

public class CreateUserCommand : IRequest<int>
{
    public string Name { get; set; }
    public string Email { get; set; }
    public int Id { get; set; }
}

public class CreateUserCommand : IRequest<int>
{
    public string Name { get; set; }
    public string Email { get; set; }
    public int Id { get; set; }
}

$vbLabelText $csharpLabel

在此範例中，CreateUserCommand 類別實作了 IRequest介面，表示此要求期望得到整數回應，這可能代表已建立使用者的 ID。

接下來，您需要為這個請求建立一個處理程式。在每個處理程式中，Handle 方法是執行請求邏輯的地方：

public class CreateUserHandler : IRequestHandler<CreateUserCommand, int>
{
    public async Task<int> Handle(CreateUserCommand command, CancellationToken token)
    {
        // Implement logic to create a user here
        // For this example, let's pretend we create a user and return the ID
        return await Task.FromResult(1); // Assume the user's ID is 1
    }
}

public class CreateUserHandler : IRequestHandler<CreateUserCommand, int>
{
    public async Task<int> Handle(CreateUserCommand command, CancellationToken token)
    {
        // Implement logic to create a user here
        // For this example, let's pretend we create a user and return the ID
        return await Task.FromResult(1); // Assume the user's ID is 1
    }
}

$vbLabelText $csharpLabel

在您的應用程式中使用 MediatR

透過遵循設定 MediatR 的相同流程，您可將其整合至應用程式的工作流程中。這通常是透過 ASP.NET Core 應用程式中的控制器或端點來完成。以下是使用 API 控制器的範例：

[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
    private readonly IMediator _mediator;

    public UsersController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost]
    public async Task<ActionResult<int>> Create(CreateUserCommand command)
    {
        var userId = await _mediator.Send(command);
        return CreatedAtRoute("GetUser", new { id = userId }, command);
    }
}

[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
    private readonly IMediator _mediator;

    public UsersController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost]
    public async Task<ActionResult<int>> Create(CreateUserCommand command)
    {
        var userId = await _mediator.Send(command);
        return CreatedAtRoute("GetUser", new { id = userId }, command);
    }
}

$vbLabelText $csharpLabel

在此控制器中，Create 動作方法透過呼叫 _mediator.Send(command) 將 CreateUserCommand 傳送至 MediatR。 MediatR 接著會為此指令找到適當的處理程式並執行。結果會傳回，並用於在相同的流程中產生回應。

超越基本要求：通知與行為

MediatR 也支援通知和行為。通知是多個處理者可以訂閱和處理的訊息，可讓您的應用程式採用事件驅動的方式。另一方面，Behaviors 類似於 MediatR 請求的中介軟體，可讓您實作日誌、驗證或交易管理等跨領域的關注事項。

IronPDF 圖書館簡介

Mediatr C# (How It Works For Developers)：圖 3 - IronPdf

IronPDF 是專為 .NET 開發人員設計的 C# 函式庫，這些開發人員需要一種簡單直接的方式在其應用程式中建立、編輯和處理 PDF 檔案，而無需考慮任何寫入問題。開發人員只需將網頁或 HTML 程式碼直接轉換為 PDF 格式，即可生成 PDF，而無需使用複雜的 API。 IronPDF 不僅限於建立 PDF；它還提供編輯 PDF 的功能，例如新增文字、圖片和頁面，甚至在 PDF 文件中填寫和編輯表格。開發人員可以全面處理 PDF，包括合併、分割以及使用密碼和權限保護 PDF 檔案等工作。

IronPdf 專精於將 HTML 轉換為 PDF 精確地保留原始版面與樣式。這使得它成為從網頁內容（如報告、發票和文件）產生 PDF 的理想選擇。它支援從 HTML 檔案、URL 甚至原始 HTML 字串轉換成 PDF 檔案。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

$vbLabelText $csharpLabel

程式碼範例

在這個範例中，假設 MediatR 請求指的是我們想要包含在 PDF 中的某種形式的媒體內容或元資料。由於 MediatR 與 IronPDF 的功能沒有直接關係，因此我們會從包含媒體資訊或參考資料的 HTML 內容來建立 PDF 文件，作為一個很好的起點。

using IronPdf;

public class PdfGenerator
{
    public void CreatePdfWithMediaInfo(string htmlContent)
    {
        // Insert your License Key here if required
        License.LicenseKey = "License-Key";

        // Initialize the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Create an HTML template with media information
        string htmlTemplate = $@"
            <html>
            <head>
                <title>Media Information</title>
            </head>
            <body>
                <h1>Media Details</h1>
                <!-- Insert your media information here -->
                {htmlContent}
            </body>
            </html>";

        // Convert the HTML string to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);
        pdfDocument.SaveAs("MediaInformation.pdf");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Example HTML content with MediatR information
        string htmlContent = @"
            <div>
                <h2>MediatR Information</h2>
                <p>MediatR is a media tracking system...</p>
            </div>";

        // Create an instance of PdfGenerator
        PdfGenerator pdfGenerator = new PdfGenerator();

        // Call the CreatePdfWithMediaInfo method to generate the PDF
        pdfGenerator.CreatePdfWithMediaInfo(htmlContent);

        Console.WriteLine("PDF generated successfully.");
    }
}

using IronPdf;

public class PdfGenerator
{
    public void CreatePdfWithMediaInfo(string htmlContent)
    {
        // Insert your License Key here if required
        License.LicenseKey = "License-Key";

        // Initialize the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Create an HTML template with media information
        string htmlTemplate = $@"
            <html>
            <head>
                <title>Media Information</title>
            </head>
            <body>
                <h1>Media Details</h1>
                <!-- Insert your media information here -->
                {htmlContent}
            </body>
            </html>";

        // Convert the HTML string to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);
        pdfDocument.SaveAs("MediaInformation.pdf");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Example HTML content with MediatR information
        string htmlContent = @"
            <div>
                <h2>MediatR Information</h2>
                <p>MediatR is a media tracking system...</p>
            </div>";

        // Create an instance of PdfGenerator
        PdfGenerator pdfGenerator = new PdfGenerator();

        // Call the CreatePdfWithMediaInfo method to generate the PDF
        pdfGenerator.CreatePdfWithMediaInfo(htmlContent);

        Console.WriteLine("PDF generated successfully.");
    }
}

$vbLabelText $csharpLabel

在此程式碼片段中，htmlContent 是一個變數，應該包含 HTML 格式的媒體資訊。這可能包括文字、圖片、影片連結或任何其他 HTML 相容的內容。 IronPDF 會將這些 HTML 內容轉換成 PDF 文件，並保留 HTML 中指定的版面與格式。

Mediatr C# (How It Works For Developers)：圖 4 - PDF 輸出

結論

Mediatr C# (How It Works For Developers)：圖 5 - 授權

透過遵循本文概述的步驟，您現在應該有了一個穩固的基礎，可以將 MediatR 整合到您的專案中，從基本的指令和查詢處理開始，到利用通知和行為等更進階的功能。當您的應用程式成長與演進時，MediatR 提供的工具與模式可協助您的程式碼保持乾淨、可維護與可擴充。

最後，值得注意的是，探索並整合不同的函式庫和工具（例如 IronPDF for .NET），可以進一步強化您的 .NET 專案。 IronPDF 提供進階 PDF 功能的免費試用。對於需要進階 PDF 功能的專案，IronPDF 的授權從 $799 開始，為想要擴充應用程式功能的 .NET 開發人員提供強大的解決方案。

常見問題解答

如何將 MediatR 整合到 ASP.NET Core 專案中？

若要將 MediatR 整合到 ASP.NET Core 專案中，請將其新增至 Program.cs 或 Startup.cs 檔案中的依賴注入容器中。您可以使用套件管理員控制台透過以下命令安裝它： Install-Package MediatR 。

在 MediatR 中，請求和處理程序扮演什麼角色？

在 MediatR 中，請求封裝了操作的細節，而處理程序則透過執行必要的業務邏輯來處理這些要求。這支援命令查詢職責分離 (CQRS) 模式，從而增強了應用程式的可維護性。

通知和行為如何增強 MediatR？

MediatR 中的通知機制允許多個處理程序對同一則訊息做出回應，從而促進事件驅動的方法。行為作為中間件，負責處理諸如日誌記錄、驗證和異常處理等橫切關注點。

在.NET應用程式中使用中介者模式有哪些好處？

MediatR 實現的中介者模式減少了組件間的直接依賴關係，從而促進了鬆散耦合。這遵循了整潔架構原則，提高了 .NET 應用程式的可維護性和可擴展性。

如何在.NET應用程式中將HTML轉換為PDF？

IronPDF 允許在 .NET 應用程式中將 HTML 轉換為 PDF。您可以使用RenderHtmlAsPdf方法轉換 HTML 字串，或使用RenderUrlAsPdf方法轉換 URL，從而確保產生的 PDF 中保留佈局。

IronPDF 為 PDF 管理提供了哪些進階功能？

IronPDF 提供進階 PDF 管理功能，例如合併、分割、編輯 PDF 文件，以及使用密碼和權限保護 PDF 文件。這些功能非常適合產生報表、發票和其他文件等任務。

MediatR 如何支援 CQRS 模式？

MediatR 透過將處理命令請求的邏輯與查詢邏輯分開來支援 CQRS 模式。這種分離使得程式碼更具可擴展性和可維護性，因為每種操作類型都可以獨立地進行最佳化和管理。

在.NET專案中使用IronPDF有哪些優勢？

IronPDF 提供了一個易於使用的 API，可在 .NET 專案中建立、編輯和管理 PDF 檔案。它能夠在將 HTML 轉換為 PDF 的同時保留佈局，使其成為產生報告和文件的強大工具。

雅各·梅勒

現在就和工程團隊聊天吧

首席技術長

Jacob Mellor 是 Iron Software 的首席技術官，也是一位富有遠見的工程師，率先開發了 C# PDF 技術。作為 Iron Software 核心程式碼庫的最初開發者，他自公司成立之初便參與塑造了其產品架構，並與執行長 Cameron Rimington 一起將其發展成為一家擁有 50 多名員工、服務於 NASA、特斯拉和全球政府機構的公司。

Jacob 於 1998 年至 2001 年在曼徹斯特大學獲得土木工程一級榮譽學士學位。 1999 年，他在倫敦創辦了自己的第一家軟體公司；2005 年，他創建了自己的第一個 .NET 元件。此後，他專注於解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF 和 IronSuite .NET 庫在全球 NuGet 上的安裝量已超過 3000 萬次，其基礎程式碼持續為全球開發者工具提供支援。憑藉 25 年的商業經驗和 41 年的程式設計專長，Jacob 始終致力於推動企業級 C#、Java 和 Python PDF 技術的創新，同時指導下一代技術領導者。

ReSharper C#（開發者使用指南）

Avalonia C#（開發者使用指南）

客戶亮點：

開發者對焦：

網路研討會：

Mediatr C#（開發者使用方法）

中介模式與 MediatR 簡介

使用套件管理員控制台在 .NET Core 專案中安裝 MediatR。

建立您的第一個 MediatR 請求與處理程式

在您的應用程式中使用 MediatR

超越基本要求：通知與行為

IronPDF 圖書館簡介

程式碼範例

結論

常見問題解答

如何將 MediatR 整合到 ASP.NET Core 專案中？

在 MediatR 中，請求和處理程序扮演什麼角色？

通知和行為如何增強 MediatR？

在.NET應用程式中使用中介者模式有哪些好處？

如何在.NET應用程式中將HTML轉換為PDF？

IronPDF 為 PDF 管理提供了哪些進階功能？

MediatR 如何支援 CQRS 模式？

在.NET專案中使用IronPDF有哪些優勢？

Mediatr C#（開發者使用方法）

中介模式與 MediatR 簡介

使用套件管理員控制台在 .NET Core 專案中安裝 MediatR。

建立您的第一個 MediatR 請求與處理程式

在您的應用程式中使用 MediatR

超越基本要求：通知與行為

IronPDF 圖書館簡介

程式碼範例

結論

常見問題解答

如何將 MediatR 整合到 ASP.NET Core 專案中？

在 MediatR 中，請求和處理程序扮演什麼角色？

通知和行為如何增強 MediatR？

在.NET應用程式中使用中介者模式有哪些好處？

如何在.NET應用程式中將HTML轉換為PDF？

IronPDF 為 PDF 管理提供了哪些進階功能？

MediatR 如何支援 CQRS 模式？

在.NET專案中使用IronPDF有哪些優勢？

相關文章

連結 CLI 的簡潔性和 .NET：將 Curl DotNet 與 IronPDF 結合使用

C# 隨機數產生器

C# 字串相等運算子（開發者使用方法）

下一步：開始30天免費試用

下一步：開始30天免費試用

深受全球數百萬工程師信賴