Palavras-chave internas em C# (Como funciona para desenvolvedores)

Exemplo de classe interna

Vamos começar com um exemplo simples. Considere um cenário em que você está desenvolvendo um aplicativo de software que inclui o gerenciamento de diferentes interfaces de usuário. Você pode criar classes internas que lidam com operações específicas de forma privada, não destinadas à exposição fora do 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");
    }
}

Friend Class UserInterfaceManager
	Friend Shared Sub DisplayUI()
		Console.WriteLine("Displaying User Interface")
	End Sub
End Class

No exemplo acima, UserInterfaceManager é uma classe interna, assim como seu método DisplayUI(). Essa configuração significa que tanto a classe quanto o método só podem ser acessados ​​dentro do mesmo assembly. Eles ficam ocultos para qualquer classe externa que tente usá-los a partir de um assembly diferente.

Exemplo de membros internos

Vamos definir uma classe com membros internos:

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}");
    }
}

Friend Class AccountProcessor
	Friend Shared accountCount As Integer = 0
	Friend Sub ProcessAccount(ByVal accountName As String)
		Console.WriteLine($"Processing {accountName}")
	End Sub
End Class

Aqui, accountCount é um membro estático interno e ProcessAccount é um método interno. Esses membros são acessíveis em qualquer classe dentro do mesmo assembly, mas permanecem ocultos para classes externas.

Modificador de acesso padrão

Em C#, se nenhum modificador de acesso for especificado para um membro de classe, o modificador de acesso padrão é private. No entanto, para classes de nível superior, o modificador de acesso padrão é internal. Isso significa que, se você não especificar um nível de acesso para uma classe, ela será interna por padrão e acessível apenas dentro do mesmo assembly.

Combinando o modificador interno com outros modificadores.

A palavra-chave internal também pode ser combinada com outros modificadores usando a combinação protected internal. Este nível de acesso permite que uma classe ou membro seja acessado por qualquer código no mesmo assembly, ou por qualquer classe derivada em outros assemblies.

Modificadores de acesso em C

Ao discutir modificadores de acesso, é importante observar que usá-los de forma privada ajuda a encapsular a funcionalidade de maneira eficaz. Lembre-se: enquanto 'internal' restringe o acesso dentro do assembly, 'private' garante que ele fique confinado à própria classe, o que é importante quando 'internal' não é a solução para suas necessidades específicas de encapsulamento.

Exemplo com classes de formulário

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

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

Friend Class MainForm
	Inherits Form

	Friend Sub New()
		InitializeComponent()
	End Sub
	Friend Sub ShowForm()
		Me.Show()
	End Sub
End Class

No código acima, MainForm é uma classe interna derivada de uma classe base Form. Este formulário e seus métodos não são acessíveis fora do assembly, protegendo o encapsulamento e a integridade dos componentes da interface do usuário do seu aplicativo.

Usando o IronPDF com a palavra-chave internal em C

Integrar o IronPDF em um projeto C# onde a palavra-chave internal é utilizada pode aprimorar a modularidade e a segurança da sua aplicação. Ao utilizar a palavra-chave interna, você pode restringir o acesso a determinadas partes da funcionalidade do seu PDF ao interior da sua montagem, garantindo que componentes críticos não sejam expostos desnecessariamente ao uso externo.

Exemplo de código: Gerando e editando um PDF

Aqui está um exemplo onde usamos o IronPDF para gerar um PDF a partir de conteúdo HTML, e encapsulamos essa funcionalidade em uma classe interna para garantir que ela permaneça acessível apenas dentro do 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);
    }
}

Imports IronPdf
Imports System

Friend Class PdfManager
	Friend Shared Sub CreatePdfFromHtml(ByVal htmlContent As String, ByVal filePath As String)
		' Create a new PDF document using IronPDF
		Dim renderer = New ChromePdfRenderer()
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
		pdf.SaveAs(filePath)

		' Output the location of the new PDF
		Console.WriteLine($"PDF created successfully at: {filePath}")
	End Sub
End Class

Public Class Program
	Public Shared Sub Main()
		' Specify the license key for IronPDF
		License.LicenseKey = "License-Key"

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

		' Creating PDF from HTML content
		PdfManager.CreatePdfFromHtml(htmlContent, filePath)
	End Sub
End Class

Neste exemplo, a classe PdfManager está marcada com a palavra-chave internal, restringindo seu acesso ao mesmo assembly. Esta classe possui um método estático CreatePdfFromHtml que recebe conteúdo HTML e um caminho de arquivo como parâmetros, usa o IronPDF para gerar um PDF a partir do HTML e o salva no caminho especificado. O método Main na classe Program serve como ponto de entrada da aplicação e chama o método interno para gerar o PDF.