Microsoft.Extensions.DependencyInjection .NET 9（PDFの作業）

依存性注入コンテナ

1. サービス登録: 依存性は通常、アプリケーションの作曲ルートで DI コンテナに登録されます。 これらの登録は、コンテナが依存性を作成し管理する方法を指定します。

2. 依存性の解決: コンポーネントが依存性を要求するとき、DI コンテナは拡張メソッドを使用して登録されたタイプのインスタンスを作成することにより依存性を解決します。

依存性注入のタイプ

• コンストラクター注入: 登録されたサービスはクラスを通じてそのコンストラクターを通じて提供されます。これは最も一般的で推奨される DI の形式です。
• メソッド注入: サービスは解決され、メソッドにパラメーターとして渡されます。
• プロパティ注入: シングルトンサービスまたはスコープされたライフタイムを持つサービスは、クラスのプロパティに割り当てられます。 しかし、このアプローチは一般的ではなく、コンストラクター注入よりも劣ると見なされることが多いです。なぜなら、隠れた依存性を招く可能性があるからです。

依存性注入 (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 は、PDF 生成の複雑なプロセスを簡素化し、PDF の操作に関する多くの機能を提供する C# の強力なライブラリであり、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 のライセンス が利用可能です。