.NET ヘルプ

内部キーワード C# (開発者にとっての仕組み)

公開済み 2024年6月6日

共有:

についてinternal キーワードC#において、コードを大規模なアプリケーション内で整理する際の基本的な概念です。このチュートリアルは、internalキーワードについての詳細な理解を提供することを目的としています。IronPDFライブラリの機能C#開発における実践的な応用。

内部キーワードとは何ですか？

C#では、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のような他の修飾子の1つです。これらの修飾子は、それぞれ異なるアクセス制御機能を提供します。

パブリック (パブリック): アクセスは制限されていません。
Private: アクセスは含まれるクラスに限定されます。
Protected：アクセスは含まれるクラスおよびその派生クラスに制限されます。
Internal: アクセスは現在のアセンブリに限定されています。

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

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

内蔵修飾子と他の修飾子の組み合わせ

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

C#におけるアクセス修飾子

アクセス修飾子について議論する際には、プライベートな方法で使用することが機能を効果的にカプセル化するのに役立つことを注記することが重要です。覚えておいてください。「internal」はアセンブリ内でのアクセスを制限しますが、「private」はクラス自身に限定されることを保証し、特殊なカプセル化のニーズに対して「internal」が答えにならない場合に重要です。

実用アプリケーション: グラフィカルユーザーインターフェースの構築

ソフトウェア開発でグラフィカルユーザーインターフェイスを構築する際、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ライブラリは、C#開発者がPDFドキュメントを生成、編集、操作するために設計された強力な.NETライブラリです。シンプルでありながら強力なPDFファイルの処理ソリューションを提供し、HTMLからPDFへの変換例機能。

このライブラリは、HTML、CSS、JavaScript、および画像などのWeb技術を高品質のPDFドキュメントに変換する際に、ピクセル完璧な精度を保証するChromeベースのレンダリングエンジンを活用しています。

C#でInternalキーワードを使用してIronPDFを使用する

C#プロジェクトにIronPDFを統合することで、internalキーワードが使用されている場合、アプリケーションのモジュール性とセキュリティが向上します。 internalキーワードを活用することで、PDF機能の特定部分へのアクセスを自身のアセンブリ内に制限し、クリティカルなコンポーネントが不必要に外部から使用されないようにすることができます。

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

以下は、HTMLコンテンツからPDFを生成するためにIronPDFを使用し、この機能を内部クラス内にカプセル化して、アセンブリ内でのみアクセス可能にする例です。

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を生成する内部メソッドを呼び出します。