C# Events（開発者向けの仕組み）

1. パブリッシャークラス

パブリッシャークラスはイベントの発信元です。 特定のアクションや条件が発生した場合にそれを宣言し、発生させる役割を担います。 このプロセスは通常、イベントが発生したときに決定するイベントハンドラーメソッドを含みます。 出版者はイベントデリゲートを使用して、イベントを処理できるメソッドの署名を定義します。 たとえば、グラフィカルユーザーインターフェース（GUI）において、ボタンコントロールは"クリック"イベントを発生させる場合に発行者として機能します。

2. サブスクライバークラス

サブスクライバークラスはイベントを監視し、それに反応します。 サブスクライバーはイベント処理メソッドをイベントにアタッチすることでイベントへの関心を登録します。 出版社がイベントを発生させると、サブスクライバーのイベントハンドラーメソッドが実行されます。 1つのイベントには複数のサブスクライバーが存在し、それぞれがイベント発生時に異なる反応をします。

3. デリゲート

デリゲートはC#におけるイベントの基礎です。 メソッドへの型安全なポインタであり、すべてのイベントハンドラーが従うべき契約を定義します。 デリゲートは、特定の署名を持つメソッドのみがイベントを処理できるようにすることで、一貫性のあるエラーフリーのイベント処理メカニズムを提供します。

4. イベントハンドラー

イベントハンドラーはサブスクライバークラス内のメソッドであり、イベントがトリガーされたときに実行されます。 UIの更新、データのログ記録、計算の実行など、イベントを処理するためのロジックを含んでいます。 イベントハンドラーの署名は、イベントに関連付けられたデリゲート型と一致する必要があります。 さらに、他のクラスもイベントハンドラーを使用して共有イベントに反応することができます。 モジュール式かつ再利用可能な方法でイベントを実装するのが容易になります。

5. イベントデータ

多くの場合、イベントはサブスクライバーに追加情報を伝える必要があります。 これはイベントデータクラスを使用して達成され、これらは基底EventArgsクラスから派生しています。 イベントデータには、メッセージ、ステータス、その他の関連情報などのイベントに関する具体的な詳細が含まれます。

ステップ1: デリゲートの宣言

デリゲートはイベントハンドラーのメソッドシグネチャを定義します。 この例では、object senderとEventArgs eという2つのパラメーターを持つイベントハンドラーを表すデリゲートを作成します。

public delegate void MyEventHandler(object sender, EventArgs e);

public delegate void MyEventHandler(object sender, EventArgs e);

ステップ2: イベントの宣言

イベントはeventキーワードを使用して宣言され、デリゲート型に基づいています。 こちらが例です：

public class Publisher
{
    public event MyEventHandler Notify; // Declare the event.
}

public class Publisher
{
    public event MyEventHandler Notify; // Declare the event.
}

ステップ3: イベントの発生

イベントはデリゲートを呼び出し、必要なパラメーターを渡すことで発生させます。

public void TriggerEvent()
{
    if (Notify != null) // Check if there are subscribers.
    {
        Notify(this, EventArgs.Empty); // Raise the event.
    }
}

public void TriggerEvent()
{
    if (Notify != null) // Check if there are subscribers.
    {
        Notify(this, EventArgs.Empty); // Raise the event.
    }
}

ステップ4: イベントのサブスクライブ

サブスクライバーは+=演算子を使用してイベントハンドラーを登録します。

Publisher publisher = new Publisher();
Subscriber subscriber = new Subscriber();
publisher.Notify += subscriber.OnNotify; // Subscribe to the event.

Publisher publisher = new Publisher();
Subscriber subscriber = new Subscriber();
publisher.Notify += subscriber.OnNotify; // Subscribe to the event.

ステップ5: イベントの処理

イベントハンドラーは、デリゲートシグネチャに一致するサブスクライバークラス内のメソッドです。

public void OnNotify(object sender, EventArgs e)
{
    Console.WriteLine("Event received!");
}

public void OnNotify(object sender, EventArgs e)
{
    Console.WriteLine("Event received!");
}

IronPDFはどのようにフィットするのか？

IronPDFを使うことで、PDFの生成、変更、セキュリティを保つことができ、イベントと統合することでアプリケーションをよりインタラクティブにすることができます。例えば：

*進捗状況の追跡:*大きな PDF レポートを生成するときに、完了率をサブスクライバーに通知します。 エラー処理:** PDF のレンダリングまたは保存中に問題が発生した場合にイベントをトリガーします。 *カスタム アクション:特定の PDF 操作の後に、ログ記録や UI の更新などのカスタム ロジックを実行します。

例: イベント通知を使用したPDFの生成

IronPDFを使用したイベントの例を示します：

using IronPdf;
using System;

// Program class
class Program
{
    // Define a custom event for progress updates
    public static event Action<int> ProgressUpdated;

    public static void Main()
    {
        License.LicenseKey = "License-Key";
        // Subscribe to the ProgressUpdated event
        ProgressUpdated += DisplayProgress;

        Console.WriteLine("Generating PDF...");
        GeneratePdf(); // Generate the PDF
    }

    // Method to generate PDF and trigger progress updates
    static void GeneratePdf()
    {
        try
        {
            var Renderer = new ChromePdfRenderer();
            for (int i = 0; i <= 100; i += 20)
            {
                // Simulate progress
                System.Threading.Thread.Sleep(500);
                ProgressUpdated?.Invoke(i); // Trigger event with progress value
            }
            // Generate a PDF
            var PdfDocument = Renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF with Events!</h1>");
            PdfDocument.SaveAs("IronPDF/example.pdf");
            ProgressUpdated?.Invoke(100); // Final update
            Console.WriteLine("PDF generated successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    // Event handler to display progress
    static void DisplayProgress(int progress)
    {
        Console.WriteLine($"Progress: {progress}%");
    }
}

using IronPdf;
using System;

// Program class
class Program
{
    // Define a custom event for progress updates
    public static event Action<int> ProgressUpdated;

    public static void Main()
    {
        License.LicenseKey = "License-Key";
        // Subscribe to the ProgressUpdated event
        ProgressUpdated += DisplayProgress;

        Console.WriteLine("Generating PDF...");
        GeneratePdf(); // Generate the PDF
    }

    // Method to generate PDF and trigger progress updates
    static void GeneratePdf()
    {
        try
        {
            var Renderer = new ChromePdfRenderer();
            for (int i = 0; i <= 100; i += 20)
            {
                // Simulate progress
                System.Threading.Thread.Sleep(500);
                ProgressUpdated?.Invoke(i); // Trigger event with progress value
            }
            // Generate a PDF
            var PdfDocument = Renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF with Events!</h1>");
            PdfDocument.SaveAs("IronPDF/example.pdf");
            ProgressUpdated?.Invoke(100); // Final update
            Console.WriteLine("PDF generated successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    // Event handler to display progress
    static void DisplayProgress(int progress)
    {
        Console.WriteLine($"Progress: {progress}%");
    }
}