Skip to footer content
.NET HELP

Simple Injector C# (How It Works For Developers)

When developing .NET applications, maintaining manageable and clean code is critical. Dependency Injection (DI) is a design pattern that facilitates loose coupling between classes, enhancing testability and maintainability. Simple Injector, a popular DI library, is renowned for its performance, flexibility, and ease of use. It allows developers to manage dependencies with minimal configuration.

IronPDF is a powerful .NET library for creating, reading, and modifying PDF documents. It supports a wide range of functionalities, including converting HTML to PDF and manipulating PDFs, making it an ideal choice for applications requiring dynamic PDF generation and handling.

This tutorial explains how to integrate IronPDF for seamless PDF creation and use Simple Injector to manage dependencies inside a C# application. By combining these two powerful tools, developers can construct applications that are more functional, scalable, maintainable, and efficient, whether it's a simple console application or a sophisticated enterprise system.

What is a Simple Injector in C#?

For .NET applications, Simple Injector is a reliable and easy-to-use Dependency Injection (DI) library. With its robust and adaptable capabilities for controlling object lifetimes and dependencies, it is designed to be straightforward. Below are some of the key features that Simple Injector offers:

Simple Injector C# (How It Works For Developers): Figure 1 - Simple injector homepage

Key Features of Simple Injector

Simplicity and Ease of Use

Simple Injector has an intuitive API that even developers unfamiliar with constructor injection can easily configure and utilize.

  • Minimal Configuration: Developers can include DI in their applications with minimal boilerplate code due to its straightforward setup.

Performance

  • High Speed: Dependency resolution is quick and efficient, making Simple Injector suitable for high-performance applications where milliseconds count.

Flexibility

  • Different Lifestyle Management: It supports a variety of lifestyles, such as transient, scoped, and singleton object lifetimes, allowing developers to choose the best lifecycle management approach for their needs.

  • Advanced Scenarios: Supports advanced DI patterns, such as decorator-based patterns and property injection.

Comprehensive Documentation

Simple Injector includes detailed and well-organized documentation, code examples, and best practices to aid developers in understanding its functionality.

Safety and Diagnostics

  • Verification: The library provides a verification step to help catch configuration errors early in the development process.

  • Diagnostic Services: Offers diagnostic services to identify and resolve common DI problems, improving application reliability.

Creating and Configuring Simple Injector in C#

The following steps show how to set up and configure Simple Injector in a C# application:

Create a New Project

Start by creating a new .NET console application. Open a terminal and execute the following commands:

dotnet new console -n SimpleInjectorExample
cd SimpleInjectorExample
dotnet new console -n SimpleInjectorExample
cd SimpleInjectorExample
SHELL

Install Simple Injector Package

Next, add the Simple Injector package to your project using NuGet:

dotnet add package SimpleInjector
dotnet add package SimpleInjector
SHELL

Set Up the Dependency Injection Container

Open the Program.cs file to configure the Simple Injector container. Here's how to set it up:

using SimpleInjector;
using System;

namespace SimpleInjectorExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create the Simple Injector container
            var container = new Container();

            // Register your types
            container.Register<IUserService, UserService>(Lifestyle.Singleton);

            // Optionally verify the container configuration
            container.Verify();

            // Resolve an instance of IUserService and use it
            var userService = container.GetInstance<IUserService>();
            userService.ProcessUser();

            Console.WriteLine("Dependency Injection with Simple Injector is set up!");
        }
    }

    // Define the service interface
    public interface IUserService
    {
        void ProcessUser();
    }

    // Implement the service
    public class UserService : IUserService
    {
        public void ProcessUser()
        {
            Console.WriteLine("Processing user...");
        }
    }
}
using SimpleInjector;
using System;

namespace SimpleInjectorExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create the Simple Injector container
            var container = new Container();

            // Register your types
            container.Register<IUserService, UserService>(Lifestyle.Singleton);

            // Optionally verify the container configuration
            container.Verify();

            // Resolve an instance of IUserService and use it
            var userService = container.GetInstance<IUserService>();
            userService.ProcessUser();

            Console.WriteLine("Dependency Injection with Simple Injector is set up!");
        }
    }

    // Define the service interface
    public interface IUserService
    {
        void ProcessUser();
    }

    // Implement the service
    public class UserService : IUserService
    {
        public void ProcessUser()
        {
            Console.WriteLine("Processing user...");
        }
    }
}
Imports SimpleInjector
Imports System

Namespace SimpleInjectorExample
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create the Simple Injector container
			Dim container As New Container()

			' Register your types
			container.Register(Of IUserService, UserService)(Lifestyle.Singleton)

			' Optionally verify the container configuration
			container.Verify()

			' Resolve an instance of IUserService and use it
			Dim userService = container.GetInstance(Of IUserService)()
			userService.ProcessUser()

			Console.WriteLine("Dependency Injection with Simple Injector is set up!")
		End Sub
	End Class

	' Define the service interface
	Public Interface IUserService
		Sub ProcessUser()
	End Interface

	' Implement the service
	Public Class UserService
		Implements IUserService

		Public Sub ProcessUser() Implements IUserService.ProcessUser
			Console.WriteLine("Processing user...")
		End Sub
	End Class
End Namespace
$vbLabelText   $csharpLabel
  • var container = new Container();: Creates an instance of the Simple Injector container class.

  • container.Register<IUserService, UserService>(Lifestyle.Singleton);: Registers the IUserService interface with its implementation UserService as a singleton. Other lifestyles, such as Transient or Scoped, can also be utilized based on the requirement.

  • container.Verify();: Verifies the container configuration, checking the validity of the registrations. This step is optional but helps identify configuration errors early.

  • var userService = container.GetInstance<IUserService>();: Resolves an instance of IUserService from the container.

  • userService.ProcessUser();: Calls the ProcessUser method on the resolved instance.

To run the application, execute the following command in your terminal:

dotnet run
dotnet run
SHELL

Simple Injector C# (How It Works For Developers): Figure 2 - Console output

Getting Started

Integrating Simple Injector with IronPDF in a C# application involves installing the required packages, configuring Simple Injector for the dependency injection pattern, and using IronPDF for PDF production. Below are the steps to help you get started.

What is IronPDF from Iron Software?

IronPDF is a powerful .NET library designed for creating, reading, and modifying PDF documents in C# applications. It allows developers to programmatically produce high-quality, print-ready documents from HTML, CSS, and JavaScript content. Some key features include watermarking, adding headers and footers, merging and splitting PDFs, and converting HTML to PDF. IronPDF supports the .NET Framework and .NET Core, making it suitable for a wide range of applications.

Developers can quickly incorporate PDF functionalities into their projects due to its comprehensive documentation and ease of integration. IronPDF also ensures that the generated PDFs closely mirror the original HTML by handling complex layouts and styling with ease.

Simple Injector C# (How It Works For Developers): Figure 3 - IronPDF: The C# PDF Library

Features of IronPDF

PDF Generation from HTML

  • Converts HTML, CSS, and JavaScript to PDF, supporting media queries and responsive design, making it useful for dynamically styling PDF documents, reports, and invoices.

PDF Editing

  • Allows adding and removing text, images, and other content from existing PDFs, merging multiple PDFs into one, or splitting PDFs into separate documents. It supports adding watermarks, annotations, headers, and footers.

PDF Conversion

  • Provides conversion of various file types (like Word, Excel, and images) to PDF and from PDF to images (PNG, JPEG, etc.).

Performance and Reliability

  • High performance and reliability are desirable in industrial environments, efficiently managing large documents.

Install IronPDF

To gain the tools required for working with PDFs in .NET apps, install the IronPDF package.

Install-Package IronPDF
Install-Package IronPDF
SHELL

Set Up the Dependency Injection Container With IronPDF

Open the Program.cs file to configure the Simple Injector container for use with IronPDF:

using SimpleInjector;
using System;
using IronPdf;

namespace SimpleInjectorIronPDFExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create the Simple Injector container
            var container = new Container();

            // Register your types
            container.Register<IPdfService, PdfService>(Lifestyle.Singleton);

            // Verify the container configuration
            container.Verify();

            // Resolve an instance of IPdfService and use it
            var pdfService = container.GetInstance<IPdfService>();
            pdfService.GeneratePdf("Hello, world!");

            Console.WriteLine("PDF generation complete!");
        }
    }

    // Define the PDF service interface
    public interface IPdfService
    {
        void GeneratePdf(string content);
    }

    // Implement the PDF service
    public class PdfService : IPdfService
    {
        public void GeneratePdf(string content)
        {
            // Create a new HtmlToPdf renderer
            var renderer = new HtmlToPdf();

            // Render the HTML content as a PDF
            var pdf = renderer.RenderHtmlAsPdf(content);

            // Save the PDF to a file
            pdf.SaveAs("output.pdf");
        }
    }
}
using SimpleInjector;
using System;
using IronPdf;

namespace SimpleInjectorIronPDFExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create the Simple Injector container
            var container = new Container();

            // Register your types
            container.Register<IPdfService, PdfService>(Lifestyle.Singleton);

            // Verify the container configuration
            container.Verify();

            // Resolve an instance of IPdfService and use it
            var pdfService = container.GetInstance<IPdfService>();
            pdfService.GeneratePdf("Hello, world!");

            Console.WriteLine("PDF generation complete!");
        }
    }

    // Define the PDF service interface
    public interface IPdfService
    {
        void GeneratePdf(string content);
    }

    // Implement the PDF service
    public class PdfService : IPdfService
    {
        public void GeneratePdf(string content)
        {
            // Create a new HtmlToPdf renderer
            var renderer = new HtmlToPdf();

            // Render the HTML content as a PDF
            var pdf = renderer.RenderHtmlAsPdf(content);

            // Save the PDF to a file
            pdf.SaveAs("output.pdf");
        }
    }
}
Imports SimpleInjector
Imports System
Imports IronPdf

Namespace SimpleInjectorIronPDFExample
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create the Simple Injector container
			Dim container As New Container()

			' Register your types
			container.Register(Of IPdfService, PdfService)(Lifestyle.Singleton)

			' Verify the container configuration
			container.Verify()

			' Resolve an instance of IPdfService and use it
			Dim pdfService = container.GetInstance(Of IPdfService)()
			pdfService.GeneratePdf("Hello, world!")

			Console.WriteLine("PDF generation complete!")
		End Sub
	End Class

	' Define the PDF service interface
	Public Interface IPdfService
		Sub GeneratePdf(ByVal content As String)
	End Interface

	' Implement the PDF service
	Public Class PdfService
		Implements IPdfService

		Public Sub GeneratePdf(ByVal content As String) Implements IPdfService.GeneratePdf
			' Create a new HtmlToPdf renderer
			Dim renderer = New HtmlToPdf()

			' Render the HTML content as a PDF
			Dim pdf = renderer.RenderHtmlAsPdf(content)

			' Save the PDF to a file
			pdf.SaveAs("output.pdf")
		End Sub
	End Class
End Namespace
$vbLabelText   $csharpLabel

This C# code demonstrates the integration of IronPDF for PDF creation and Simple Injector for dependency injection into a .NET console application. A Simple Injector container is created to handle dependencies, registering IPdfService and its implementation PdfService as singletons to ensure a single instance is used throughout the application. The container configuration is verified to catch any registration issues early.

Simple Injector C# (How It Works For Developers): Figure 4 - Console output

In the Main method, an instance of IPdfService is resolved from the container and its GeneratePdf method is called. This method generates a PDF using IronPDF's HtmlToPdf class from a provided HTML string and saves the resulting document as output.pdf. A console message indicating the completion of PDF generation signals the end of the operation. This setup illustrates how to effectively manage dependencies and use IronPDF for creating dynamic PDF documents in a structured and maintainable manner.

Simple Injector C# (How It Works For Developers): Figure 5 - Example PDF output

Conclusion

Integrating Simple Injector with IronPDF in a C# application effectively manages dependencies and simplifies dynamic PDF creation. Simple Injector provides robust performance and a straightforward API for dependency injection, ensuring maintainable and loosely coupled components. When paired with IronPDF's powerful PDF generation capabilities, developers can easily convert HTML content into high-quality PDF documents. By leveraging the attribute-based configuration methods and understanding these tools, developers can streamline their approach to managing dependencies and fulfilling feature requirements.

This combination not only enhances code manageability and scalability but also simplifies complex tasks like PDF creation. By following the steps outlined in this tutorial, you can build a robust architecture leveraging Simple Injector and IronPDF, resulting in more structured, adaptable, and powerful .NET applications.

Lastly, consider adding IronPDF and explore more products from Iron Software to your .NET programming arsenal to work with barcodes, generate PDFs, perform OCR, and connect with Excel. Learn more about IronPDF's features for efficient development by integrating its functionality with Iron Software's flexible systems and suite, starting at a price of $749.

Well-defined license options allow developers to tailor models best suited to their project's specific requirements, enabling them to address a range of issues in an easily integrated, effective, and transparent manner.

Frequently Asked Questions

How can I convert HTML to PDF in C#?

You can use IronPDF's RenderHtmlAsPdf method to convert HTML strings into PDFs. Additionally, IronPDF supports converting HTML files directly using the RenderHtmlFileAsPdf method.

What is Simple Injector in C# and how is it useful?

Simple Injector is a straightforward Dependency Injection library for .NET applications. It aids in managing object lifetimes and dependencies efficiently, enhancing code simplicity and performance.

How do you set up Simple Injector in a C# project?

To set up Simple Injector, you need to add the Simple Injector package via NuGet to your .NET project, configure the container in your Program.cs file, register your types, and verify the container configuration for accuracy.

What are the benefits of using Simple Injector with IronPDF?

Combining Simple Injector with IronPDF allows for better code manageability and scalability. It simplifies the process of PDF generation in .NET applications, ensuring a more maintainable and loosely coupled codebase.

How can a dependency injection library improve PDF generation in C# applications?

By using Simple Injector with IronPDF, developers can easily manage dependencies and streamline the process of generating PDFs. This integration ensures that components are loosely coupled, enhancing the maintainability and scalability of the application.

What features does a .NET PDF library like IronPDF offer?

IronPDF offers a wide range of features including converting HTML to PDF, editing existing PDFs, and supporting complex layouts. It ensures that the generated PDFs closely match the original HTML content.

How can you troubleshoot common issues when integrating Simple Injector with a PDF library?

Ensure that all services are registered correctly in the Simple Injector container. Verify that the container is properly configured and that dependencies are resolved at runtime. Utilize diagnostic services provided by Simple Injector for further troubleshooting.

What steps are involved in generating a PDF from HTML in a .NET application?

To generate a PDF from HTML in a .NET application using IronPDF, install the IronPDF package, configure a Simple Injector container for dependency injection, and use IronPDF's HtmlToPdf renderer to convert HTML content into a PDF document.

What lifestyle management options does Simple Injector offer?

Simple Injector provides various lifestyle management options such as transient, singleton, and scoped lifetimes, allowing developers to control how and when objects are instantiated in their applications.

Chipego
Software Engineer
Chipego has a natural skill for listening that helps him to comprehend customer issues, and offer intelligent solutions. He joined the Iron Software team in 2023, after studying a Bachelor of Science in Information Technology. IronPDF and IronOCR are the two products Chipego has been focusing on, but his knowledge of ...Read More