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

What is Simple Injector in C#?

Simple Injector is a reliable and easy-to-use Dependency Injection (DI) library for .NET applications. It offers robust and adaptable capabilities for controlling object lifetimes and dependencies, designed to be straightforward.

How does Simple Injector benefit .NET developers?

Simple Injector benefits .NET developers by providing an intuitive API for easy configuration, high-speed dependency resolution, and support for different lifestyle management options. It also includes comprehensive documentation and diagnostic services to improve application reliability.

How can I set up Simple Injector in a C# application?

To set up Simple Injector, start by creating a .NET project, add the Simple Injector package via NuGet, and configure the container in your `Program.cs` file. Register your types and verify the container configuration to ensure proper setup.

What is a .NET library for handling PDF documents and what are its features?

IronPDF is a .NET library for creating, reading, and modifying PDF documents. It supports features like converting HTML to PDF, editing PDFs, and converting various file types to and from PDF. It ensures generated PDFs closely mirror the original HTML content.

How do you integrate a dependency injection library with a PDF library in a C# application?

To integrate Simple Injector with IronPDF, install the required packages, configure Simple Injector for DI, and use IronPDF for PDF production. Register the PDF service in the Simple Injector container and use it to generate PDFs in your application.

What is the benefit of using a dependency injection library with a PDF library?

Using Simple Injector with IronPDF enhances code manageability, scalability, and simplifies complex tasks like PDF creation. It ensures maintainable, loosely coupled components and allows developers to convert HTML content into high-quality PDF documents effectively.

What are the key features of a dependency injection library?

Key features of Simple Injector include simplicity and ease of use, high performance, flexibility in lifestyle management, comprehensive documentation, and diagnostic services for identifying and resolving common DI problems.

How can a dependency injection library improve application reliability?

Simple Injector improves application reliability through its verification step to catch configuration errors early and diagnostic services that help identify and resolve common DI problems.

What steps are involved in creating a PDF with a .NET library in a C# application?

To create a PDF with IronPDF, install the IronPDF package, set up a Simple Injector container for DI, and define a PDF service that uses IronPDF's `HtmlToPdf` renderer to convert HTML content into a PDF document. Save the resulting document as needed.

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 all products is growing daily, as he finds new ways to support customers. He enjoys how collaborative life is at Iron Software, with team members from across the company bringing their varied experience to contribute to effective, innovative solutions. When Chipego is away from his desk, he can often be found enjoying a good book or playing football.