Internal Keyword 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

上記の例では、UserInterfaceManagerはinternalクラスであり、そのメソッドDisplayUI()も同様です。 この設定により、クラスとメソッドの両方が同じアセンブリ内でのみアクセス可能となります。 それらは異なるアセンブリから使用しようとする外部クラスから隠されています。

Internalメンバーの例

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

ここでは、accountCountがinternal静的メンバーで、ProcessAccountがinternalメソッドです。 これらのメンバーは同じアセンブリのいずれかのクラスでアクセス可能ですが、外部クラスからは隠されています。

デフォルトのアクセス修飾子

C#では、クラスメンバーに対してアクセス修飾子が指定されていない場合、デフォルトのアクセス修飾子はprivateです。 ただし、トップレベルクラスの場合、デフォルトのアクセス修飾子はinternalです。 これは、クラスにアクセスレベルを指定しない場合、デフォルトでinternalとなり、同じアセンブリ内でのみアクセス可能であることを意味します。

internalと他の修飾子の組み合わせ

internalキーワードはprotected internalの組み合わせを使用して他の修飾子と組み合わせることもできます。 このアクセスレベルにより、クラスまたはメンバーは同じアセンブリの任意のコードから、または他のアセンブリの派生クラスからアクセスできます。

C#のアクセス修飾子

アクセス修飾子について話す際、プライベートな方法で使用することにより、機能を効果的にカプセル化するのに役立つことを示すことが重要です。 アセンブリ内でアクセスを制限する'internal'と、クラス自体に制限する'private'をうまく使い分けすることは重要です。

フォームクラスの例

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

上記のコードでは、MainFormがinternalクラスであり、基本的なFormクラスから派生しています。 このフォームとそのメソッドはアセンブリ外部ではアクセスできず、アプリケーションのユーザーインターフェイスコンポーネントのカプセル化と整合性を保護します。

IronPDFとC#でのinternalキーワードの使用

internalキーワードを利用したC#プロジェクトにIronPDFを統合することで、アプリケーションのモジュール性とセキュリティを強化できます。 internalキーワードを活用することで、アセンブリ内でのみPDF機能の一部へのアクセスを制限し、重要なコンポーネントが不必要に外部に公開されないようにすることが可能です。

コード例：PDFの生成と編集

ここでは、HTMLコンテンツからPDFを生成するためにIronPDFを使用し、この機能をinternalクラス内にカプセル化して、アセンブリ内でのみアクセス可能な状態にする例を示します：

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

この例では、PdfManagerクラスがinternalキーワードでマークされており、同じアセンブリにのみアクセスを制限しています。 このクラスには静的メソッドCreatePdfFromHtmlがあり、HTMLコンテンツとファイルパスをパラメーターとして受け取り、IronPDFを使用してHTMLからPDFを生成し、指定されたパスに保存します。 アプリケーションのエントリーポイントとして機能するProgramクラスのMainメソッドが、このinternalメソッドを呼び出してPDFを生成します。