Ao gerenciar a visibilidade de classes de formulário, métodos e propriedades dentro de um programa principal estático (void), os modificadores de acesso são essenciais na linguagem de programação C#, que é baseada em componentes. Ao construir interfaces gráficas de usuário modulares e de fácil manutenção, um modificador de acesso bastante relevante é o "internal". Neste artigo, discutiremos o conceito de "C# internal" , juntamente com diversas aplicações úteis para o IronPDF, um framework C# flexível para gerenciamento de documentos PDF.

Como usar membros internos no desenvolvimento baseado em componentes C#

1. Crie um projeto em C#.
2. Compreenda o modificador de acesso interno.
3. Aplicar o critério 'interno' aos membros.
4. Organize o código no nível de montagem.
5. Utilize elementos internos dentro da mesma montagem.
6. Compile o código.

Entendendo o Modificador de Acesso Interno

A palavra-chave interna/modificador de acesso em C# limita a visibilidade de um tipo ou membro àquela de outros membros dentro do mesmo assembly. Isso implica que qualquer classe, seja ela uma classe derivada, um método ou uma propriedade marcada como interna, pode ser acessada por outros tipos dentro do mesmo assembly, mas não está disponível para tipos fora do assembly. Esse nível de controle de acesso é essencial para o encapsulamento, pois permite especificar detalhes de implementação que devem ser usados ​​exclusivamente dentro do mesmo assembly de forma privada.

Em C#, você pode usar o modificador interno das seguintes maneiras:

Classe interna

Declarar uma classe que está disponível apenas dentro do mesmo assembly usando o atributo internal.

// Assembly1
internal class InternalClass
{
    // Members of InternalClass
}

// Assembly1
internal class InternalClass
{
    // Members of InternalClass
}

' Assembly1
Friend Class InternalClass
	' Members of InternalClass
End Class

' Assembly1
Friend Class InternalClass
	' Members of InternalClass
End Class

Membros da Classe Interna

Limitar a visibilidade dos membros da classe, como campos, propriedades e métodos, ao mesmo assembly aplicando um atributo internal.

// Assembly1
internal class MyClass
{
    internal static int InternalField;
    internal void InternalMethod() { }
}

// Assembly1
internal class MyClass
{
    internal static int InternalField;
    internal void InternalMethod() { }
}

' Assembly1
Friend Class [MyClass]
	Friend Shared InternalField As Integer
	Friend Sub InternalMethod()
	End Sub
End Class

' Assembly1
Friend Class [MyClass]
	Friend Shared InternalField As Integer
	Friend Sub InternalMethod()
	End Sub
End Class

Interface interna

Declarar uma interface que só pode ser acessada dentro do mesmo assembly usando o modificador de acesso interno.

// Assembly1
internal interface IInternalInterface
{
    // Interface members
}

// Assembly1
internal interface IInternalInterface
{
    // Interface members
}

' Assembly1
Friend Interface IInternalInterface
	' Interface members
End Interface

' Assembly1
Friend Interface IInternalInterface
	' Interface members
End Interface

Classe Aninhada Interna

Declarar uma classe aninhada que só pode ser acessada dentro do mesmo assembly usando o atributo internal.

// Assembly1
public class OuterClass
{
    internal class InternalNestedClass
    {
        // Members of InternalNestedClass
    }
}

// Assembly1
public class OuterClass
{
    internal class InternalNestedClass
    {
        // Members of InternalNestedClass
    }
}

' Assembly1
Public Class OuterClass
	Friend Class InternalNestedClass
		' Members of InternalNestedClass
	End Class
End Class

' Assembly1
Public Class OuterClass
	Friend Class InternalNestedClass
		' Members of InternalNestedClass
	End Class
End Class

Montagem interna

Limitar o acesso a toda a montagem a partir de montagens externas, aplicando restrições internas no nível da montagem.

using System.Runtime.CompilerServices;

// Allowing "ExternalAssembly" to access internal members of this assembly
[assembly: InternalsVisibleTo("ExternalAssembly")]

using System.Runtime.CompilerServices;

// Allowing "ExternalAssembly" to access internal members of this assembly
[assembly: InternalsVisibleTo("ExternalAssembly")]

Imports System.Runtime.CompilerServices

' Allowing "ExternalAssembly" to access internal members of this assembly
<Assembly: InternalsVisibleTo("ExternalAssembly")>

Imports System.Runtime.CompilerServices

' Allowing "ExternalAssembly" to access internal members of this assembly
<Assembly: InternalsVisibleTo("ExternalAssembly")>

Durante o desenvolvimento e teste, os modificadores de acesso interno podem ser disponibilizados para um assembly externo designado usando o atributo InternalsVisibleTo.

// Assembly A
public class MyClassA
{
    internal void MyInternalMethod()
    {
        // Implementation details only accessible within Assembly A
    }
}

// Assembly B
public class MyClassB
{
    void SomeMethod()
    {
        MyClassA myObject = new MyClassA();
        myObject.MyInternalMethod(); // This will result in a compilation error
    }
}

// Assembly A
public class MyClassA
{
    internal void MyInternalMethod()
    {
        // Implementation details only accessible within Assembly A
    }
}

// Assembly B
public class MyClassB
{
    void SomeMethod()
    {
        MyClassA myObject = new MyClassA();
        myObject.MyInternalMethod(); // This will result in a compilation error
    }
}

' Assembly A
Public Class MyClassA
	Friend Sub MyInternalMethod()
		' Implementation details only accessible within Assembly A
	End Sub
End Class

' Assembly B
Public Class MyClassB
	Private Sub SomeMethod()
		Dim myObject As New MyClassA()
		myObject.MyInternalMethod() ' This will result in a compilation error
	End Sub
End Class

' Assembly A
Public Class MyClassA
	Friend Sub MyInternalMethod()
		' Implementation details only accessible within Assembly A
	End Sub
End Class

' Assembly B
Public Class MyClassB
	Private Sub SomeMethod()
		Dim myObject As New MyClassA()
		myObject.MyInternalMethod() ' This will result in a compilation error
	End Sub
End Class

Como MyInternalMethod é designado como um membro interno neste exemplo, ele só pode ser acessado dentro do Assembly A. Ocorrerá um erro de compilação se você tentar acessar essa função a partir do Assembly B.

A combinação dos modificadores de acesso protegido e interno resulta no modificador de acesso interno protegido. Um membro (método, propriedade ou campo) ou um tipo (classe, interface ou delegado) pode ser acessado tanto dentro quanto fora de seu assembly por tipos derivados, graças a um modificador de acesso composto interno protegido. O nível de acesso interno protegido proporciona um equilíbrio entre a visibilidade que os níveis de acesso protegido e interno oferecem separadamente.

IronPDF

Utilizando a linguagem de programação C#, o site oficial do IronPDF é uma biblioteca .NET que permite aos desenvolvedores gerar, editar e modificar documentos PDF. Oferece uma variedade de ferramentas e recursos para interagir com arquivos PDF de diversas maneiras, incluindo a criação de PDFs a partir de HTML, a conversão de HTML para PDF, a combinação ou divisão de documentos PDF e a adição de anotações, texto e fotos a PDFs já existentes.

Instale o IronPDF

Obtenha a biblioteca IronPDF ; É necessário para a atualização futura. Para realizar essa ação, digite o seguinte comando no Console do Gerenciador de Pacotes:

Install-Package IronPdf

Utilizar o Gerenciador de Pacotes NuGet para procurar o pacote "IronPDF" é uma opção adicional. Podemos escolher e baixar o pacote necessário a partir desta lista de todos os pacotes NuGet associados ao IronPDF.

O IronPDF se destaca na conversão de HTML para PDF , garantindo a preservação precisa dos layouts e estilos originais. É perfeito para criar PDFs a partir de conteúdo da web, como relatórios, faturas e documentação. Com suporte para arquivos HTML, URLs e strings HTML brutas, o IronPDF produz facilmente documentos PDF de alta qualidade.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

Funcionalidades do IronPDF

• Converter HTML para PDF: Com o IronPDF, você pode criar documentos PDF a partir de qualquer tipo de informação HTML, incluindo arquivos, URLs e trechos de código HTML.
• Geração de PDF: Usando a linguagem de programação C#, você pode adicionar texto, gráficos e outros componentes a documentos PDF programaticamente.
• Manipulação de PDF: O IronPDF oferece recursos para dividir um arquivo PDF em vários arquivos, combinar vários documentos PDF em um único arquivo e modificar PDFs já existentes.
• Formulários em PDF: A biblioteca é útil em situações onde é necessário coletar e processar dados de formulários, pois permite que os usuários criem e preencham formulários em PDF.
• Recursos de segurança: Os documentos PDF podem ser protegidos por senha e permissões e criptografados usando o IronPDF.
• Extração de texto: O IronPDF pode ser usado para extrair texto de arquivos PDF.

Encapsulamento do processamento de PDFs com IronPDF

O IronPDF oferece uma vasta gama de recursos para gerar, modificar e processar documentos PDF. Os detalhes de implementação podem ser mantidos ocultos dentro dos limites do assembly, encapsulando o código de processamento de PDF em classes ou métodos internos. Para saber mais sobre o IronPDF, consulte a Documentação do IronPDF .

Analise a seguinte situação:

// Assembly A (PDFHandlingLibrary)
internal class PdfProcessor
{
    internal void AddWatermark(IronPdf.PdfDocument pdfDocument, string watermarkText)
    {
        // Implementation details for adding a watermark using IronPDF
    }

    internal IronPdf.PdfDocument MergePdfDocuments(IEnumerable<IronPdf.PdfDocument> pdfDocuments)
    {
        // Implementation details for merging PDF documents using IronPDF
        IronPdf.PdfDocument mergedPdfDocument = new IronPdf.PdfDocument();
        // Logic to merge documents
        return mergedPdfDocument;
    }
}

// Assembly B (MainApplication)
public class MainClass
{
    void ProcessPdfDocuments()
    {
        // Create an instance of the PdfProcessor within the same assembly
        PdfProcessor pdfProcessor = new PdfProcessor();

        // Assuming pdfDocumentList is defined
        IEnumerable<IronPdf.PdfDocument> pdfDocumentList = new List<IronPdf.PdfDocument>();
        
        // Accessing internal methods within the same assembly is allowed
        pdfProcessor.AddWatermark(new IronPdf.PdfDocument(), "Confidential");
        IronPdf.PdfDocument mergedPdf = pdfProcessor.MergePdfDocuments(pdfDocumentList);
    }
}

// Assembly A (PDFHandlingLibrary)
internal class PdfProcessor
{
    internal void AddWatermark(IronPdf.PdfDocument pdfDocument, string watermarkText)
    {
        // Implementation details for adding a watermark using IronPDF
    }

    internal IronPdf.PdfDocument MergePdfDocuments(IEnumerable<IronPdf.PdfDocument> pdfDocuments)
    {
        // Implementation details for merging PDF documents using IronPDF
        IronPdf.PdfDocument mergedPdfDocument = new IronPdf.PdfDocument();
        // Logic to merge documents
        return mergedPdfDocument;
    }
}

// Assembly B (MainApplication)
public class MainClass
{
    void ProcessPdfDocuments()
    {
        // Create an instance of the PdfProcessor within the same assembly
        PdfProcessor pdfProcessor = new PdfProcessor();

        // Assuming pdfDocumentList is defined
        IEnumerable<IronPdf.PdfDocument> pdfDocumentList = new List<IronPdf.PdfDocument>();
        
        // Accessing internal methods within the same assembly is allowed
        pdfProcessor.AddWatermark(new IronPdf.PdfDocument(), "Confidential");
        IronPdf.PdfDocument mergedPdf = pdfProcessor.MergePdfDocuments(pdfDocumentList);
    }
}

' Assembly A (PDFHandlingLibrary)
Friend Class PdfProcessor
    Friend Sub AddWatermark(pdfDocument As IronPdf.PdfDocument, watermarkText As String)
        ' Implementation details for adding a watermark using IronPDF
    End Sub

    Friend Function MergePdfDocuments(pdfDocuments As IEnumerable(Of IronPdf.PdfDocument)) As IronPdf.PdfDocument
        ' Implementation details for merging PDF documents using IronPDF
        Dim mergedPdfDocument As New IronPdf.PdfDocument()
        ' Logic to merge documents
        Return mergedPdfDocument
    End Function
End Class

' Assembly B (MainApplication)
Public Class MainClass
    Private Sub ProcessPdfDocuments()
        ' Create an instance of the PdfProcessor within the same assembly
        Dim pdfProcessor As New PdfProcessor()

        ' Assuming pdfDocumentList is defined
        Dim pdfDocumentList As IEnumerable(Of IronPdf.PdfDocument) = New List(Of IronPdf.PdfDocument)()

        ' Accessing internal methods within the same assembly is allowed
        pdfProcessor.AddWatermark(New IronPdf.PdfDocument(), "Confidential")
        Dim mergedPdf As IronPdf.PdfDocument = pdfProcessor.MergePdfDocuments(pdfDocumentList)
    End Sub
End Class

' Assembly A (PDFHandlingLibrary)
Friend Class PdfProcessor
    Friend Sub AddWatermark(pdfDocument As IronPdf.PdfDocument, watermarkText As String)
        ' Implementation details for adding a watermark using IronPDF
    End Sub

    Friend Function MergePdfDocuments(pdfDocuments As IEnumerable(Of IronPdf.PdfDocument)) As IronPdf.PdfDocument
        ' Implementation details for merging PDF documents using IronPDF
        Dim mergedPdfDocument As New IronPdf.PdfDocument()
        ' Logic to merge documents
        Return mergedPdfDocument
    End Function
End Class

' Assembly B (MainApplication)
Public Class MainClass
    Private Sub ProcessPdfDocuments()
        ' Create an instance of the PdfProcessor within the same assembly
        Dim pdfProcessor As New PdfProcessor()

        ' Assuming pdfDocumentList is defined
        Dim pdfDocumentList As IEnumerable(Of IronPdf.PdfDocument) = New List(Of IronPdf.PdfDocument)()

        ' Accessing internal methods within the same assembly is allowed
        pdfProcessor.AddWatermark(New IronPdf.PdfDocument(), "Confidential")
        Dim mergedPdf As IronPdf.PdfDocument = pdfProcessor.MergePdfDocuments(pdfDocumentList)
    End Sub
End Class

Neste exemplo, a classe PdfProcessor do assembly A usa o IronPDF para encapsular o código de processamento de PDF. Como os métodos são designados como internos, eles só podem ser acessados ​​por outros membros internos da mesma montagem. O MainClass do Assembly B pode facilmente fazer uso dessas funções internas. Para saber mais sobre o código IronPDF , consulte o exemplo de conversão de HTML para PDF do IronPDF .

Conclusão

Por fim, o modificador interno do C# oferece um controle rigoroso sobre quais tipos e membros são visíveis dentro de um assembly. Quando usado em conjunto com o IronPDF, ele ajuda a criar aplicativos seguros, modulares e de fácil manutenção. Você pode encontrar um equilíbrio entre abstração, segurança e usabilidade ao encapsular o código relacionado ao IronPDF dentro de classes ou métodos internos. Ao trabalhar com bibliotecas como o IronPDF , que gerenciam funções essenciais como o processamento de documentos PDF, é especialmente importante adotar os conceitos de encapsulamento e acesso limitado para promover uma arquitetura estável e escalável em seus aplicativos C#.

Uma licença muito robusta, opções de redesenho e uma duração mais longa de suporte de programação estão todos incluídos no pacote leve $999 do IronPDF. Os clientes podem testar o produto em ambientes de aplicação reais durante o período de teste com marca d'água. Saiba mais sobre o licenciamento do IronPDF para entender os benefícios, o processo de aprovação e o formulário de rascunho. Acesse o site da Iron Software para saber mais.