Internal Keyword C# (How It Works For Developers)

Example of Internal Class

Let's start with a simple example. Consider a scenario where you are building a software application that includes managing different user interfaces. You might create internal classes that handle specific operations in a private manner, not intended for exposure outside the assembly.

internal class UserInterfaceManager
{
    internal static void DisplayUI()
    {
        Console.WriteLine("Displaying User Interface");
    }
}

internal class UserInterfaceManager
{
    internal static void DisplayUI()
    {
        Console.WriteLine("Displaying User Interface");
    }
}

In the above example, UserInterfaceManager is an internal class, and so is its method DisplayUI(). This setup means that both the class and the method can only be accessed within the same assembly. They are hidden from any external class that attempts to use them from a different assembly.

Example of Internal Members

Let’s define a class with internal members:

internal class AccountProcessor
{
    internal static int accountCount = 0;
    internal void ProcessAccount(string accountName)
    {
        Console.WriteLine($"Processing {accountName}");
    }
}

internal class AccountProcessor
{
    internal static int accountCount = 0;
    internal void ProcessAccount(string accountName)
    {
        Console.WriteLine($"Processing {accountName}");
    }
}

Here, accountCount is an internal static member, and ProcessAccount is an internal method. These members are accessible within any class in the same assembly but remain hidden from any external classes.

Default Access Modifier

In C#, if no access modifier is specified for a class member, the default access modifier is private. However, for top-level classes, the default access modifier is internal. This means that if you do not specify an access level for a class, it is internal by default and accessible only within the same assembly.

Combining Internal with Other Modifiers

The internal keyword can also be combined with other modifiers using the protected internal combination. This access level allows a class or member to be accessed by any code in the same assembly, or by any derived class in other assemblies.

Access Modifiers in C#

While discussing access modifiers, it's important to note that using them in a private manner helps to encapsulate functionality effectively. Remember, while 'internal' restricts access within the assembly, 'private' ensures it is confined to the class itself, important when 'internal' is not the answer to your specific encapsulation needs.

Example with Form Classes

internal class MainForm : Form
{
    internal MainForm()
    {
        InitializeComponent();
    }
    internal void ShowForm()
    {
        this.Show();
    }
}

internal class MainForm : Form
{
    internal MainForm()
    {
        InitializeComponent();
    }
    internal void ShowForm()
    {
        this.Show();
    }
}

In the above code, MainForm is an internal class derived from a base Form class. This form and its methods are not accessible outside the assembly, protecting the encapsulation and integrity of your application’s user interface components.

Using IronPDF with the Internal Keyword in C#

Integrating IronPDF in a C# project where the internal keyword is utilized can enhance modularity and security within your application. By leveraging the internal keyword, you can restrict access to certain parts of your PDF functionality to within your assembly, ensuring that critical components are not unnecessarily exposed to external use.

Code Example: Generating and Editing a PDF

Here is an example where we use IronPDF to generate a PDF from HTML content, and we encapsulate this functionality within an internal class to ensure that it remains accessible only within the assembly:

using IronPdf;
using System;

internal class PdfManager
{
    internal static void CreatePdfFromHtml(string htmlContent, string filePath)
    {
        // Create a new PDF document using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs(filePath);

        // Output the location of the new PDF
        Console.WriteLine($"PDF created successfully at: {filePath}");
    }
}

public class Program
{
    public static void Main()
    {
        // Specify the license key for IronPDF
        License.LicenseKey = "License-Key";

        // Example HTML content to convert to PDF
        string htmlContent = "<h1>Welcome to IronPDF</h1><p>This is a PDF generated from HTML using IronPDF.</p>";
        string filePath = "example.pdf";

        // Creating PDF from HTML content
        PdfManager.CreatePdfFromHtml(htmlContent, filePath);
    }
}

using IronPdf;
using System;

internal class PdfManager
{
    internal static void CreatePdfFromHtml(string htmlContent, string filePath)
    {
        // Create a new PDF document using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs(filePath);

        // Output the location of the new PDF
        Console.WriteLine($"PDF created successfully at: {filePath}");
    }
}

public class Program
{
    public static void Main()
    {
        // Specify the license key for IronPDF
        License.LicenseKey = "License-Key";

        // Example HTML content to convert to PDF
        string htmlContent = "<h1>Welcome to IronPDF</h1><p>This is a PDF generated from HTML using IronPDF.</p>";
        string filePath = "example.pdf";

        // Creating PDF from HTML content
        PdfManager.CreatePdfFromHtml(htmlContent, filePath);
    }
}

In this example, the PdfManager class is marked with the internal keyword, restricting its accessibility to the same assembly. This class has a static method CreatePdfFromHtml that takes HTML content and a file path as parameters, uses IronPDF to generate a PDF from the HTML, and saves it to the specified path. The Main method in the Program class serves as the entry point of the application and calls the internal method to generate the PDF.