C# Call Base Constructor (How It Works For Developers)

The 'base' Keyword in Constructor Calls

The base keyword in C# is used within a derived class to refer to the base class. It is particularly useful in constructor declaration when you need to invoke the constructor of the base class instead of the derived constructor. Using the base keyword, the inherited constructor can specify which base class constructor should be executed to engage the appropriate constructor body. This capability is essential when the base class does not have a public parameterless constructor, or specific initialization in the base class needs to be performed.

Consider a scenario where you have a public class-derived class that inherits from a base class. The base class might have a private constructor or a public one that takes an integer parameter:

public class BaseClass {
    public int b;
    public BaseClass(int b) {
        this.b = b;
    }
}

public class BaseClass {
    public int b;
    public BaseClass(int b) {
        this.b = b;
    }
}

The derived class needs to call this constructor to properly initialize the base class part of its objects:

public class DerivedClass : BaseClass {
    public DerivedClass(int b) : base(b) {
        // Additional initialization for DerivedClass
    }
}

public class DerivedClass : BaseClass {
    public DerivedClass(int b) : base(b) {
        // Additional initialization for DerivedClass
    }
}

In this example: base(b) explicitly calls the base class constructor with the parameter b. This ensures that the field b in the base class is initialized before the derived class constructor proceeds with its body.

Handling Multiple Constructors

Often, both base and derived classes might have multiple constructors. The derived class can choose which base class constructor to call. This selection is critical when the base class constructors perform different kinds of initialization.

public class BaseClass {
    public BaseClass() {
        // Default constructor
    }
    public BaseClass(int b) {
        this.b = b;
    }
}
public class DerivedClass : BaseClass {
    public DerivedClass() : base() {
        // Calls the parameterless constructor of the base class
    }
    public DerivedClass(int b) : base(b) {
        // Calls the base class constructor that takes an int
    }
}

public class BaseClass {
    public BaseClass() {
        // Default constructor
    }
    public BaseClass(int b) {
        this.b = b;
    }
}
public class DerivedClass : BaseClass {
    public DerivedClass() : base() {
        // Calls the parameterless constructor of the base class
    }
    public DerivedClass(int b) : base(b) {
        // Calls the base class constructor that takes an int
    }
}

In this setup, DerivedClass provides flexibility by corresponding to the base class's constructors, ensuring all forms of initialization provided by BaseClass are accessible, depending on the needs during object creation.

Code Example

To demonstrate using IronPDF in C# to create a PDF from HTML, you can use a base class that initializes IronPDF and a derived class that uses this initialization to create a PDF. Here’s an example of how you might structure this using a base constructor:

using IronPdf;

// Base class for PDF generation
public class PdfGenerator
{
    protected ChromePdfRenderer Renderer;

    // Base constructor initializes the HTML to PDF renderer
    public PdfGenerator()
    {
        Renderer = new ChromePdfRenderer();
        // Additional configuration
    }
}

// Derived class uses the base class to generate a specific PDF
public class SpecificPdfGenerator : PdfGenerator
{
    public void CreateSimplePdf(string htmlContent, string filePath)
    {
        // Uses the Renderer from the base class
        var pdfDocument = Renderer.RenderHtmlAsPdf(htmlContent);
        pdfDocument.SaveAs(filePath);
    }
}

// Usage
class Program
{
    static void Main(string[] args)
    {
        License.LicenseKey = "License-Key";
        var htmlContent = "<h1>Hello, IronPDF!</h1>";
        var filePath = "example.pdf";
        var pdfCreator = new SpecificPdfGenerator();
        pdfCreator.CreateSimplePdf(htmlContent, filePath);
    }
}

using IronPdf;

// Base class for PDF generation
public class PdfGenerator
{
    protected ChromePdfRenderer Renderer;

    // Base constructor initializes the HTML to PDF renderer
    public PdfGenerator()
    {
        Renderer = new ChromePdfRenderer();
        // Additional configuration
    }
}

// Derived class uses the base class to generate a specific PDF
public class SpecificPdfGenerator : PdfGenerator
{
    public void CreateSimplePdf(string htmlContent, string filePath)
    {
        // Uses the Renderer from the base class
        var pdfDocument = Renderer.RenderHtmlAsPdf(htmlContent);
        pdfDocument.SaveAs(filePath);
    }
}

// Usage
class Program
{
    static void Main(string[] args)
    {
        License.LicenseKey = "License-Key";
        var htmlContent = "<h1>Hello, IronPDF!</h1>";
        var filePath = "example.pdf";
        var pdfCreator = new SpecificPdfGenerator();
        pdfCreator.CreateSimplePdf(htmlContent, filePath);
    }
}

This code structure promotes reusability and modularity, making it easier to manage different PDF generation needs within larger applications.

Output