.NET 幫助

C# 內部關鍵字（它如何為開發人員運作）

發佈 2024年6月6日

這內部關鍵字在 C# 中，特別是在大型應用程式中組織代碼時，這是一個基本概念。本教程旨在提供對 internal 關鍵字的詳細理解及IronPDF 函式庫功能及其在 C# 開發中的實際應用。

什麼是 Internal 關鍵字？

在 C# 中，internal 關鍵字是一個存取修飾符，用於定義類別、方法、變數和其他成員的存取方式。使用 internal 關鍵字指定對類別或成員的訪問限制在同一個程序集內的程式碼中。

這在您希望控制某些組件的可見性，確保它們不暴露於所屬程式集之外的情境中特別有用。

內部類的範例

讓我們從一個簡單的例子開始。考慮一個情境，您正在建立一個包含管理不同使用者界面的軟體應用程式。您可能會創建處理特定操作的內部類別，以私密的方式運行，無意在程式集外部公開。

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

VB C#

在上述範例中，UserInterfaceManager 是一個內部類別，其方法 DisplayUI 亦是如此。()`. 這種設置意味著類別和方法只能在同一個程序集內訪問。它們被隱藏，任何嘗試從不同程序集中使用它們的外部類都無法訪問。

理解內部成員和方法

內部成員，例如欄位、屬性、方法和事件，可以使用 internal 關鍵字標記。以這種方式標記的內部成員確保了可及性僅限於同一個組件內，這是一種處理基於組件開發的安全方法。

內部成員範例

讓我們定義一個包含內部成員的類別：

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

VB C#

在這裡，accountCount 是一個內部靜態成員，ProcessAccount 是一個內部方法。這些成員在同一個組件中的任何類別中都可以訪問，但對任何外部類別保持隱藏。

C# 的訪問修飾符

C# 中的存取修飾符定義了如何存取類別和類別成員。 internal 是其中一個修飾符，與其他如 public、private 和 protected 並列。這些修飾詞中的每一個都提供不同的存取控制功能：

Public：存取不受限制。
Private：存取範圍限制在包含該成員的類別內。
Protected：訪問僅限於包含類別及其衍生類別。
Internal：存取限制在當前的組件內。

預設存取修飾符

在 C# 中，如果類別成員沒有指定存取修飾詞，則默認的存取修飾詞是 private。然而，對於最上層的類別，預設的存取修飾符是 internal。這意味著如果您未為類別指定存取層級，則預設為內部，只能在相同的組件中存取。

將內部與其他修飾符結合

internal 關鍵字也可以與其他修飾符組合使用，形成 protected internal 組合。此存取層級允許同一個組件中的任何程式碼或其他組件中的任何衍生類別存取該類別或成員。

C# 的訪問修飾符

在討論訪問修飾符時，重要的是要注意以私有方式使用它們有助於有效封裝功能。請記住，雖然「internal」限制了在組件內的訪問，但「private」則確保它被限制在類本身內，這在「internal」不能滿足您特定的封裝需求時尤為重要。

實用應用：構建圖形用戶介面

在開發涉及構建圖形用戶界面的軟體時，使用 internal 關鍵字可以幫助您有效地管理組件。例如，您可能有多個僅在相同程式集內相關的表單類別。通過將這些類標記為內部類別，您可以確保它們僅在預定的地方使用，而不會在其他地方使用。

表單類別示例

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

VB C#

在上述代碼中，MainForm 是從基礎 Form 類派生的內部類別。此表單及其方法在程序集外部無法訪問，保護應用程式用戶介面元件的封裝和完整性。

IronPDF 介紹

IronPDF 庫是一個強大的 .NET 函式庫，專為 C# 開發人員設計，用於生成、編輯和操作 PDF 文件。它提供了一個簡單而強大的解決方案，用於處理 PDF 文件，利用了HTML 轉 PDF 轉換範例功能。

該庫利用基於Chrome的渲染引擎，在轉換過程中確保像素級精確度，將HTML、CSS、JavaScript和圖像等網頁技術轉換為高質量的PDF文件。

在 C# 中使用 IronPDF 與 Internal 關鍵字

在使用 internal 關鍵字的 C# 項目中整合 IronPDF，可以提高應用程序的模塊化和安全性。通過利用 internal 關鍵字，您可以將 PDF 功能的某些部分的訪問限制在您的程序集內，確保關鍵組件不會不必要地暴露給外部使用。

代碼範例：生成和編輯 PDF

以下是一個使用 IronPDF 從 HTML 內容生成 PDF 的範例，我們將此功能封裝在內部類別中，以確保僅在程序集內可訪問：

using IronPdf;
using System;
internal class PdfManager
{
    internal static void CreatePdfFromHtml(string htmlContent, string filePath)
    {
        // Create a new PDF document
        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()
    {
        License.LicenseKey = "License-Key";
        // Example HTML content
        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
        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()
    {
        License.LicenseKey = "License-Key";
        // Example HTML content
        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
		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()
		License.LicenseKey = "License-Key"
		' Example HTML content
		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

VB C#

內部關鍵字 C#（對開發人員的工作原理）：圖1

在此範例中，PdfManager 類別被標記為 internal 關鍵字，限制其可訪問性僅限於相同的組件。此類別有一個靜態方法 CreatePdfFromHtml，其接受 HTML 內容和檔案路徑作為參數，利用 IronPDF 從 HTML 產生 PDF，並將其儲存到指定路徑。在 Program 類別中的 Main 方法作為應用程式的進入點，並呼叫內部方法來生成 PDF。