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

對於 .NET 應用程式，Autofac 是功能強大且輕量的 Inversion of Control (IoC) 容器。 簡單來說，Autofac 可協助您管理應用程式中不同部分（類別或服務）之間的依存關係。 它是 Internet of Containers (IoC) 容器家族的成員，支援依賴注入 (DI)，這是一種設計範例，藉由賦予外部框架對於取得依賴關係的控制，鼓勵類別之間的松散耦合。

依賴注入 (DI)

有了 Autofac，依賴注入變得更容易，它讓您可以將依賴注入到您的類別中，而不需要從頭開始建立。 明確宣告相依性可鼓勵鬆散耦合並改善可測性。

靈活的元件註冊

Autofac 提供了多種方法，用於在容器中註冊元件（類別或服務）。 對於更複雜的情況，您可以利用慣例或模組，並依類型、實例或委託來註冊元件。

終身管理

對於註冊的元件，Autofac 提供許多生命週期：Instance Per Dependency（每個請求有新的實例）、Instance Per Lifetime Scope（每個請求或會話有一個實例）、Singleton（每個容器有一個實例）等等。 由於這種彈性，您可以決定在何時及多久內舉行實例。

自動依賴解析

註冊後，Autofac 可自動解決元件之間的依賴關係。 它可以消除模板程式碼，並透過理解元件之間的依賴關係，確保在需要時提供元件，從而提高程式的可維護性。

與 .NET 生態系統整合。

受歡迎的 .NET Framework 和函式庫，例如 ASP.NET Core、ASP.NET MVC、Web API、WCF 和網頁表單整合，都能輕鬆與 Autofac 整合。 為了簡化這些框架內的設定和使用，它提供了延伸點和整合套件。

擴充性與模組化

Autofac 利用巢狀容器和模組促進模組化設計。 模組可將相關的設定和元件組合起來，有助於管理大型應用程式，從而促進程式碼的重複使用。

FakeItEasy Mocking 框架整合

Autofac 支援與 FakeItEasy 整合，可輕鬆模擬單元測試的相依性。 此整合有助於建立虛假物件和模擬實作，確保穩健可靠的測試環境。

多租客依賴解析支援。

Autofac 為多租戶應用程式提供內建支援，允許不同元件共存，並根據租戶特定的上下文進行解析。 這項能力對於服務多個客戶端或具有不同配置的環境的應用程式而言至關重要。

啟用點圖形可視化

Autofac 可透過 Dot 圖形可視化，實現元件關係和依賴關係的可視化。 此功能有助於理解和優化應用程式相依圖的組成，提高透明度和故障排除。

Moq Mocking 框架整合

Autofac 可與另一種流行的 .NET 模擬框架 Moq 無縫整合。 此整合可簡化單元測試期間模擬物件的建立與管理，確保在受控的測試情境中，依賴物件的行為符合預期。

進階功能

Autofac 的進階功能包括攔截 (為元件新增跨領域的關注，例如快取或日誌)、裝飾器 (透明地修改元件行為)，以及支援 keyed 服務與 metadata (根據上下文區分實作)。

設定選項

透過 Autofac 廣泛的組態選項，您可以使用組態建置工具、XML 組態檔案或程式碼來組態容器。 因此，可根據各種部署條件和偏好進行調整。

建立與設定 Autofac .NET

在 .NET 應用程式中建立和設定 Autofac 涉及多個流程：容器設定、元件和啟動類註冊、生命期管理，以及應用程式框架整合。 以下是使用 Autofac 的基本方法：

在 Visual Studio 中建立控制台專案是一個簡單的過程。 使用這些簡單的步驟在 Visual Studio 環境中啟動 Console Application：

使用前請確認您已在個人電腦上安裝 Visual Studio。

開始新專案

選取檔案，然後選取專案，然後選取新增選項。

。

從下列專案範本參考清單中，您可以選擇"Console App"或"Console App (.NET Core)"範本。

請填寫"名稱"欄位，為您的專案命名。

決定存放專案的位置。

按一下"建立"將開啟 Console 應用程式專案。

。

安裝 Autofac NuGet 套件

首先，請確定您的專案已載入 Autofac 套件。 可使用 NuGet Package Manager Console 進行安裝：

Install-Package Autofac

設定 Autofac Container

在應用程式的啟動程式碼中設定並建構 Autofac 容器（Program.cs 適用於控制台應用程式，Global.asax.cs 適用於 ASP.NET 應用程式，Startup.cs 適用於 ASP.NET Core 應用程式）：

using Autofac;
using System;

public class Program
{
    public static void Main(string[] args)
    {
        // Initialize Autofac container
        var container = ConfigureContainer();

        // Resolve your main application entry point or start your app
        using (var scope = container.BeginLifetimeScope())
        {
            var app = scope.Resolve<MyApplication>(); // Resolve your main application class
            app.Run();
        }
    }

    private static IContainer ConfigureContainer()
    {
        var builder = new ContainerBuilder();

        // Register components
        builder.RegisterType<MyService>().As<IMyService>().InstancePerLifetimeScope();
        // Add more registrations as needed
        builder.RegisterType<MyApplication>().UsingConstructor(typeof(IMyService));

        // Build the Autofac container
        return builder.Build();
    }
}

public class MyApplication
{
    private readonly IMyService _myService;

    public MyApplication(IMyService myService)
    {
        _myService = myService;
    }

    public void Run()
    {
        // Use _myService and other resolved dependencies here
        _myService.DoSomething();
        Console.WriteLine("Application is running...");
    }
}

public interface IMyService
{
    void DoSomething();
}

public class MyService : IMyService
{
    public void DoSomething()
    {
        Console.WriteLine("MyService is doing something...");
    }
}

using Autofac;
using System;

public class Program
{
    public static void Main(string[] args)
    {
        // Initialize Autofac container
        var container = ConfigureContainer();

        // Resolve your main application entry point or start your app
        using (var scope = container.BeginLifetimeScope())
        {
            var app = scope.Resolve<MyApplication>(); // Resolve your main application class
            app.Run();
        }
    }

    private static IContainer ConfigureContainer()
    {
        var builder = new ContainerBuilder();

        // Register components
        builder.RegisterType<MyService>().As<IMyService>().InstancePerLifetimeScope();
        // Add more registrations as needed
        builder.RegisterType<MyApplication>().UsingConstructor(typeof(IMyService));

        // Build the Autofac container
        return builder.Build();
    }
}

public class MyApplication
{
    private readonly IMyService _myService;

    public MyApplication(IMyService myService)
    {
        _myService = myService;
    }

    public void Run()
    {
        // Use _myService and other resolved dependencies here
        _myService.DoSomething();
        Console.WriteLine("Application is running...");
    }
}

public interface IMyService
{
    void DoSomething();
}

public class MyService : IMyService
{
    public void DoSomething()
    {
        Console.WriteLine("MyService is doing something...");
    }
}

註冊元件

Autofac 中的元件與 ContainerBuilder 註冊。 服務（介面或基類）及其實作由您指定：

var builder = new ContainerBuilder();

// Register components
builder.RegisterType<MyService>().As<IMyService>().InstancePerLifetimeScope();
// Add more registrations as needed
builder.RegisterType<MyApplication>().UsingConstructor(typeof(IMyService));

// Build the Autofac container
return builder.Build();

var builder = new ContainerBuilder();

// Register components
builder.RegisterType<MyService>().As<IMyService>().InstancePerLifetimeScope();
// Add more registrations as needed
builder.RegisterType<MyApplication>().UsingConstructor(typeof(IMyService));

// Build the Autofac container
return builder.Build();

MyService 在此以 IMyService 登入。 根據您應用程式的需求，您可以註冊許多元件並指定生命週期 (例如 InstancePerLifetimeScope、SingleInstance、InstancePerDependency)。

什麼是 IronPDF Library？

對於在 C# 程式中建立、閱讀和編輯 PDF 文件，有一種強大的 .NET 函式庫，稱為 IronPDF for .NET。 它可讓開發人員從 HTML、CSS 和 JavaScript 內容建立 PDF，讓他們以程式化的方式輕鬆製作高品質、可直接列印的文件。 其中最重要的功能包括：水印、建立頁眉、頁腳、分割與合併 PDF，以及將 HTML 轉換為 PDF。 由於 IronPDF 同時支援 .NET Framework 和 .NET Core，因此可以用於許多應用程式。

由於 PDF 擁有廣泛的文件且容易整合，因此開發人員可快速將其納入專案中。 IronPDF 可輕鬆處理複雜的版面設計和樣式，確保輸出的 PDF 與原始 HTML 文本非常相似。

IronPDF 的特點

從 HTML 產生 PDF

將 HTML、CSS 及 JavaScript 轉換為 PDF。 它支援兩個現代網路標準：媒體查詢和反應式設計。 這對使用 HTML 和 CSS 動態裝飾 PDF 發票、報告和文件很有幫助。

PDF編輯

文字、圖片和其他類型的素材都可以加入到已存在的 PDF 中。 從 PDF 檔案中萃取文字和影像。 將許多 PDF 合併為單一檔案。將 PDF 檔案分割成多個文件。 新增頁眉、頁腳、註解和水印。

PDF 轉檔

將 Word、Excel 和影像檔案等其他檔案類型轉換為 PDF。 將 PDF 轉換為影像（PNG、JPEG 等）。

效能與可靠性

在工業環境中，高效能和高可靠性是理想的設計特質。 有效率地處理大型文件管理。

安裝 IronPDF

安裝 IronPDF 套件，即可獲得在 .NET 程式中處理 PDF 所需的工具。

Install-Package IronPDF

使用 IronPdf 設定 Autofac 容器。

在您的應用程式中設定 Autofac 以處理相依性，其中包括與 IronPDF 相連的部分。

using Autofac;
using IronPdf;
using System;
using System.IO;

public class Program
{
    public static void Main(string[] args)
    {
        // Initialize Autofac container
        var container = ConfigureContainer();

        // Resolve your main application entry point or start your app
        using (var scope = container.BeginLifetimeScope())
        {
            var app = scope.Resolve<MyApplication>(); // Resolve your main application class
            app.Run();
        }
    }

    private static IContainer ConfigureContainer()
    {
        var builder = new ContainerBuilder();

        // Register components
        builder.RegisterType<PdfGenerator>().As<IPdfGenerator>().InstancePerLifetimeScope();
        // Add more registrations as needed

        // Build the Autofac container
        return builder.Build();
    }
}

public class MyApplication
{
    private readonly IPdfGenerator _pdfGenerator;

    public MyApplication(IPdfGenerator pdfGenerator)
    {
        _pdfGenerator = pdfGenerator;
    }

    public void Run()
    {
        // Use _pdfGenerator and other resolved dependencies here
        Console.WriteLine("Application is running...");

        // Example usage of IronPDF for generating a PDF
        var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
        var pdfBytes = _pdfGenerator.GeneratePdf(htmlContent);

        using (var fs = new FileStream("output.pdf", FileMode.Create, FileAccess.Write))
        {
            fs.Write(pdfBytes, 0, pdfBytes.Length);
        }

        // Save or further process the generated PDF bytes
    }
}

public interface IPdfGenerator
{
    byte[] GeneratePdf(string htmlContent);
}

public class PdfGenerator : IPdfGenerator
{
    public byte[] GeneratePdf(string htmlContent)
    {
        var renderer = new IronPdf.ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
        Console.WriteLine("Pdf generation completed");
        return pdfDocument.BinaryData;
    }
}

using Autofac;
using IronPdf;
using System;
using System.IO;

public class Program
{
    public static void Main(string[] args)
    {
        // Initialize Autofac container
        var container = ConfigureContainer();

        // Resolve your main application entry point or start your app
        using (var scope = container.BeginLifetimeScope())
        {
            var app = scope.Resolve<MyApplication>(); // Resolve your main application class
            app.Run();
        }
    }

    private static IContainer ConfigureContainer()
    {
        var builder = new ContainerBuilder();

        // Register components
        builder.RegisterType<PdfGenerator>().As<IPdfGenerator>().InstancePerLifetimeScope();
        // Add more registrations as needed

        // Build the Autofac container
        return builder.Build();
    }
}

public class MyApplication
{
    private readonly IPdfGenerator _pdfGenerator;

    public MyApplication(IPdfGenerator pdfGenerator)
    {
        _pdfGenerator = pdfGenerator;
    }

    public void Run()
    {
        // Use _pdfGenerator and other resolved dependencies here
        Console.WriteLine("Application is running...");

        // Example usage of IronPDF for generating a PDF
        var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
        var pdfBytes = _pdfGenerator.GeneratePdf(htmlContent);

        using (var fs = new FileStream("output.pdf", FileMode.Create, FileAccess.Write))
        {
            fs.Write(pdfBytes, 0, pdfBytes.Length);
        }

        // Save or further process the generated PDF bytes
    }
}

public interface IPdfGenerator
{
    byte[] GeneratePdf(string htmlContent);
}

public class PdfGenerator : IPdfGenerator
{
    public byte[] GeneratePdf(string htmlContent)
    {
        var renderer = new IronPdf.ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
        Console.WriteLine("Pdf generation completed");
        return pdfDocument.BinaryData;
    }
}

建立 PDF 的抽象/介面稱為 IPdfGenerator。 PdfGenerator 是 IPdfGenerator 的實作，可使用 IronPDF 的 ChromePdfRenderer class 從 HTML 素材建立 PDF。 Autofac 透過 ConfigureContainer 函式，將 PdfGenerator 設定為註冊 IPdfGenerator 實作。 通過使用構建器注入將 IPdfGenerator 依賴注入到 MyApplication 類中，PdfGenerator (IronPDF) 可以輕鬆地被 MyApplication 使用。

現在，只要注入 IPdfGenerator，您就可以透過 PdfGenerator 存取 IronPDF 的功能 (本例中為 HtmlToPdf)。 修改 PdfGenerator 以滿足您應用程式的需求； 例如，新增頁眉、頁腳或調整 PDF 參數。 這些教學將告訴您如何使用 Autofac 進行依賴注入，並將 IronPDF 強大的 PDF 製作功能整合到您的 C# 應用程式中。 根據您專案的特殊需求和架構，修改配置和註冊。