Podczas zarządzania widocznością klas formularzy, metod i właściwości w programie static void main, modyfikatory dostępu są niezbędne w języku programowania C# opartym na komponentach. Podczas tworzenia modułowych i łatwych w utrzymaniu graficznych interfejsów użytkownika jednym z istotnych modyfikatorów dostępu jest internal. W niniejszym artykułe omówiona zostanie koncepcja C# internal, a także kilka przydatnych zastosowań IronPDF, elastycznego frameworka C# do zarządzania dokumentami PDF.

Jak uzywac elementow wewnetrznych w rozwoju komponentow C#

1. Utwórz projekt w języku C#.
2. Zrozumienie wewnętrznego modyfikatora dostępu.
3. Zastosuj "internal" do elementów.
4. Organizuj kod na poziomie asemblera.
5. Używaj elementów wewnętrznych w ramach tego samego zestawu.
6. Skompiluj kod.

Zrozumienie wewnętrznego modyfikatora dostępu

Wewnętrzne słowo kluczowe/modyfikator dostępu w języku C# ogranicza widoczność typu lub elementu składowego do innych elementów składowych w tym samym zestawie. Oznacza to, że każda klasa, niezależnie od tego, czy jest to klasa pochodna, metoda czy właściwość oznaczona jako wewnętrzna, jest dostępna dla innych typów w ramach tego samego zestawu, ale niedostępna dla typów spoza zestawu. Ten poziom kontroli dostępu jest niezbędny dla enkapsulacji, ponieważ pozwala określić szczegóły implementacji, które powinny być używane wyłącznie wewnątrz tego samego modułu w sposób prywatny.

W języku C# można używać modyfikatora internal w następujący sposób:

Klasa wewnętrzna

Deklarowanie klasy, która jest dostępna tylko w ramach tego samego zestawu, za pomocą 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

Wewnętrzne elementy klasy

Ograniczenie widoczności elementów klasy, takich jak pola, właściwości i metody, do tego samego zestawu poprzez zastosowanie atrybutu 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

Interfejs wewnętrzny

Deklarowanie interfejsu, do którego dostęp jest możliwy wyłącznie w ramach tego samego modułu, przy użyciu modyfikatora dostępu internal.

// 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

Wewnętrzna klasa zagnieżdżona

Deklarowanie klasy zagnieżdżonej, do której dostęp jest możliwy tylko w obrębie tego samego zestawu za pomocą 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

Zespół wewnętrzny

Ograniczanie dostępu do całego zestawu z zewnętrznych zestawów poprzez zastosowanie atrybutu internal na poziomie zestawu.

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

Podczas tworzenia i testowania, wewnętrzne modyfikatory dostępu mogą zostać udostępnione wskazanej zewnętrznej bibliotece poprzez użycie atrybutu 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

Ponieważ MyInternalMethod jest oznaczony jako wewnętrzny członek w tym przykładzie, może być dostępny wyłącznie w obrębie Assembly A. Jeśli spróbujesz uzyskać dostęp do tej funkcji z zestawu B, wystąpi błąd kompilacji.

Połączenie modyfikatorów dostępu protected i internal daje modyfikator dostępu protected internal. Dostęp do elementu (metody, właściwości lub pola) lub typu (klasy, interfejsu lub delegata) jest możliwy zarówno wewnątrz, jak i na zewnątrz jego zestawu przez typy pochodne dzięki chronionemu wewnętrznym złożonemu modyfikatorowi dostępu. Równowagę między widocznością zapewnianą oddzielnie przez poziomy dostępu chronionego i wewnętrznego zapewnia poziom dostępu chronionego wewnętrznego.

IronPDF

Wykorzystując język programowania C#, IronPDF Official Site jest biblioteką .NET, która umożliwia programistom generowanie, edycję i modyfikację dokumentów PDF. Oferuje szereg narzędzi i funkcji umożliwiających interakcję z plikami PDF na wiele sposobów, w tym tworzenie plików PDF z HTML, konwersję HTML do PDF, łączenie lub dzielenie dokumentów PDF oraz dodawanie adnotacji, tekstu i zdjęć do już istniejących plików PDF.

Zainstaluj IronPDF

Pobierz bibliotekę IronPDF; Jest to potrzebne do przyszłej aktualizacji. Aby to zrobić, wpisz następujące polecenie w konsoli menedżera pakietów:

Install-Package IronPdf

Dodatkową opcją jest użycie menedżera pakietów NuGet do wyszukania pakietu "IronPDF". Możemy wybrać i pobrać niezbędny pakiet z tej listy wszystkich pakietów NuGet powiązanych z IronPDF.

IronPDF wyróżnia się w konwersji HTML do PDF, zapewniając precyzyjne zachowanie oryginalnych układów i stylów. Idealnie nadaje się do tworzenia plików PDF z treści internetowych, takich jak raporty, faktury i dokumentacja. Dzięki obsłudze plików HTML, adresów URL i surowych ciągów znaków HTML, IronPDF z łatwością tworzy wysokiej jakości dokumenty 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");
    }
}

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

Funkcje IronPDF

• Konwersja HTML do PDF: Dzięki IronPDF możesz tworzyć dokumenty PDF z dowolnego rodzaju informacji HTML, w tym plików, adresów URL i ciągów kodu HTML.
• Generowanie plików PDF: Korzystając z języka programowania C#, można programowo dodawać tekst, grafikę i inne elementy do dokumentów PDF.
• Manipulacja plikami PDF: IronPDF oferuje funkcje podziału pliku PDF na wiele plików, łączenia wielu dokumentów PDF w jeden plik oraz modyfikacji już istniejących plików PDF.
• Formularze PDF: Biblioteka jest pomocna w sytuacjach, w których konieczne jest gromadzenie i przetwarzanie danych z formularzy, ponieważ umożliwia użytkownikom tworzenie i wypełnianie formularzy PDF.
• Funkcje bezpieczeństwa: Dokumenty PDF mogą być chronione hasłem i uprawnieniami oraz szyfrowane przy użyciu IronPDF.
• Wyodrębnianie tekstu: IronPDF może służyć do wyodrębniania tekstu z plików PDF.

Enkapsulacja obsługi plików PDF za pomocą IronPDF

IronPDF oferuje szeroki zakres funkcji do generowania, modyfikowania i przetwarzania dokumentów PDF. Szczegóły implementacji można ukryć za granicami zestawów, umieszczając kod przetwarzania plików PDF w klasach lub metodach wewnętrznych. Aby dowiedzieć się więcej o IronPDF, zapoznaj się z dokumentacją IronPDF.

Rozważmy następującą sytuację:

// 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

W tym przykładzie klasa PdfProcessor z Assembly A wykorzystuje IronPDF do enkapsulacji kodu przetwarzania PDF. Ponieważ metody są oznaczone jako wewnętrzne, dostęp do nich mają wyłącznie inne elementy wewnętrzne tego samego zestawu. Assembly B's MainClass może łatwo korzystać z tych wewnętrznych funkcji. Aby dowiedzieć się więcej o kodzie IronPDF, zapoznaj się z przykładem konwersji HTML do PDF w IronPDF.

Wnioski

Wreszcie, modyfikator internal w języku C# zapewnia ścisłą kontrolę nad tym, które typy i elementy są widoczne wewnątrz zestawu. W połączeniu z IronPDF pomaga tworzyć bezpieczne, modułowe i łatwe w utrzymaniu aplikacje. Można osiągnąć kompromis między abstrakcyjnością, bezpieczeństwem i użytecznością, umieszczając kod związany z IronPDF wewnątrz klas lub metod wewnętrznych. Podczas pracy z bibliotekami takimi jak IronPDF, które zarządzają podstawowymi funkcjami, takimi jak przetwarzanie dokumentów PDF, szczególnie ważne jest stosowanie koncepcji enkapsulacji i ograniczonego dostępu w celu zapewnienia stabilnej i skalowalnej architektury w aplikacjach C#.

Bardzo solidna licencja, opcje przeprojektowania i dłuższy okres wsparcia dla programowania są zawarte w pakiecie $999 light IronPDF. Klienci mogą przetestować produkt w rzeczywistych warunkach aplikacji podczas okresu testowego z znakiem wodnym. Dowiedz się więcej o licencjonowaniu IronPDF, aby poznać korzyści, proces zatwierdzania i formularz wniosku. Więcej informacji można znaleźć na stronie internetowej Iron Software.