Microsoft.Extensions.DependencyInjection.NET 9（處理 PDF）

依賴注入容器

1.服務註冊：相依性在 DI 容器中註冊，通常位於應用程式的組成根目錄。 這些註冊規定容器應如何建立和管理相依性。

2.依賴解析：當元件請求依賴時，DI 容器會透過建立使用擴充方法的註冊類型實例來解析依賴。

依賴注入的類型

• 建構子注入：透過類別的建構子提供註冊服務，這是最常見也是最推薦的 DI 形式。
• 方法注入：服務被解析並作為參數傳送給方法。
• Property Injection：單件服務或具有範圍生命週期的服務可以指定給類的屬性。 然而，這種方法較不常見，而且常被認為不如構建器注入，因為它可能會引入隱藏的依賴關係。

瞭解依賴注入 (DI) 的生命期：範圍、暫態和單體。

1.作用域：作用域依賴在每個請求或生命週期作用域中建立一次，這表示容器在單一請求或作業中提供相同的實體。 這種一致性在 Web 應用程式中特別有用，因為範圍相依性有助於在整個 Web 請求中維持穩定的相依性。 2.暫態：暫態依賴每次從容器請求時都會被實體化。 這意味著只要有需要，就會產生新的暫態依賴實例。 通常，瞬態依賴用於輕量級、無狀態的服務或元件。 3.單件：單件相依性僅實體化一次，並在應用程式的整個生命週期中共用。這可確保在應用程式的整個生命週期中，所有請求都會使用相同的單一依賴實體。 對於需要在整個應用程式中普遍存取的有狀態服務或元件，通常會使用單件式相依性。

安裝Microsoft.Extensions.DependencyInjection套件

Install-Package Microsoft.Extensions.DependencyInjection

範例：基本的依賴注入

在本範例中，讓我們建立一個範例應用程式 (主控台應用程式)，其中我們將運用服務提供者來解析服務，並將它們注入我們的程式中。

using Microsoft.Extensions.DependencyInjection;
using System;

// Define a service interface
public interface IMessageService
{
    void SendMessage(string message);
}

// Implement the service interface
public class ConsoleMessageService : IMessageService
{
    public void SendMessage(string message)
    {
        Console.WriteLine(message); // Output the message to the console
    }
}

using Microsoft.Extensions.DependencyInjection;
using System;

// Define a service interface
public interface IMessageService
{
    void SendMessage(string message);
}

// Implement the service interface
public class ConsoleMessageService : IMessageService
{
    public void SendMessage(string message)
    {
        Console.WriteLine(message); // Output the message to the console
    }
}

該程式碼片段建立了一個用於傳送訊息的介面 IMessageService ，就像是一份訊息傳送方式的合約。 ConsoleMessageService 類透過使用 Console.WriteLine 傳送訊息來實作此介面。 這樣的分離使得傳送訊息的概念可以獨立於訊息的傳送方式而改變，讓系統變得更靈活、更易於管理。

class Program
{
    static void Main(string[] args)
    {
        // Create a service provider
        var serviceProvider = new ServiceCollection()
            // Register the service implementation
            .AddTransient<IMessageService, ConsoleMessageService>()
            .BuildServiceProvider();

        // Resolve the service
        var messageService = serviceProvider.GetRequiredService<IMessageService>();

        // Use the service to send a message
        messageService.SendMessage("Hello, From Dependency Injection!");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Create a service provider
        var serviceProvider = new ServiceCollection()
            // Register the service implementation
            .AddTransient<IMessageService, ConsoleMessageService>()
            .BuildServiceProvider();

        // Resolve the service
        var messageService = serviceProvider.GetRequiredService<IMessageService>();

        // Use the service to send a message
        messageService.SendMessage("Hello, From Dependency Injection!");
    }
}

此代碼設定了一個 serviceProvider 來管理服務。 它將 ConsoleMessageService 註冊為 IMessageService 的實作，使其可在任何需要的地方注入。 然後 Main 方法會從 serviceProvider 擷取 IMessageService 的實體，並使用它傳送訊息到控制台。

輸出：程式列印字串訊息 "Hello, From Dependency Injection!"

IronPDF：C# PDF 函式庫

IronPDF是一個功能強大的 C# 函式庫，可簡化複雜的 PDF 產生過程，提供廣泛的 PDF 操作功能，包括從 HTML 產生 PDF的能力、操作將文字新增至 PDF 和使用影像編輯 PDF、建立安全的文件等等。

public interface IPdfService
{
    void GeneratePdf(string baseUrl, string query, string filePath);
}

public interface IPdfService
{
    void GeneratePdf(string baseUrl, string query, string filePath);
}

using IronPdf;
using System;
using System.Web;

// Implement the PDF generation interface
public class IronPdfService : IPdfService
{
    public void GeneratePdf(string baseUrl, string query, string filePath)
    {
        License.LicenseKey = "Your-License-Key"; // Set the IronPDF license key
        string encodedQuery = HttpUtility.UrlEncode(query); // Encode the query string
        string fullUrl = $"{baseUrl}?query={encodedQuery}"; // Construct the full URL
        var renderer = new ChromePdfRenderer(); // Create a PDF renderer
        var pdf = renderer.RenderUrlAsPdf(fullUrl); // Render the PDF from the URL
        pdf.SaveAs(filePath); // Save the PDF to the specified file path
        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}

using IronPdf;
using System;
using System.Web;

// Implement the PDF generation interface
public class IronPdfService : IPdfService
{
    public void GeneratePdf(string baseUrl, string query, string filePath)
    {
        License.LicenseKey = "Your-License-Key"; // Set the IronPDF license key
        string encodedQuery = HttpUtility.UrlEncode(query); // Encode the query string
        string fullUrl = $"{baseUrl}?query={encodedQuery}"; // Construct the full URL
        var renderer = new ChromePdfRenderer(); // Create a PDF renderer
        var pdf = renderer.RenderUrlAsPdf(fullUrl); // Render the PDF from the URL
        pdf.SaveAs(filePath); // Save the PDF to the specified file path
        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}

builder.Services.AddSingleton<IPdfService, IronPdfService>();

builder.Services.AddSingleton<IPdfService, IronPdfService>();

public class MyController : Controller
{
    private readonly IPdfService _pdfService;

    public MyController(IPdfService pdfService)
    {
        _pdfService = pdfService;
    }

    public IActionResult GeneratePdf()
    {
        string baseUrl = "https://ironpdf.com/";
        string query = "Hello World from IronPDF !";
        string filePath = "Demo.pdf";

        // Use the injected PDF service to generate a PDF
        _pdfService.GeneratePdf(baseUrl, query, filePath);

        return View();
    }
}

public class MyController : Controller
{
    private readonly IPdfService _pdfService;

    public MyController(IPdfService pdfService)
    {
        _pdfService = pdfService;
    }

    public IActionResult GeneratePdf()
    {
        string baseUrl = "https://ironpdf.com/";
        string query = "Hello World from IronPDF !";
        string filePath = "Demo.pdf";

        // Use the injected PDF service to generate a PDF
        _pdfService.GeneratePdf(baseUrl, query, filePath);

        return View();
    }
}

結論

Microsoft.Extensions.DependencyInjection是.NET 6中實施依賴注入的強大工具，可促進應用程式的鬆散耦合並提升可測性。 透過整合 IronPDF 這個功能豐富的 C# 函式庫，開發人員可以輕鬆地以最少的工作量產生全面的 PDF 文件。 可取得 IronPDF 的授權。