C# Etkinlikler (Geliştiriciler İçin Nasıl Çalışır)

1. Yayıncı Sınıfı

Yayıncı sınıf, olayın kaynağıdır. Belirli bir eylem veya durum meydana geldiğinde olayı ilan etmekten ve tetiklemekten sorumludur. Bu süreç genellikle bir olayın ne zaman gerçekleştiğini belirlemek için bir olay işleyici yöntemini içerir. Yayıncı ayrıca olayın ele alınabileceği yöntemlerin imzasını tanımlamak için bir olay delege kullanır. Örneğin, bir grafik kullanıcı arayüzünde (GUI), bir "Tıklama" olayı tetiklediğinde bir düğme kontrolü yayıncı görevi görür.

2. Abone Sınıfı

Abone sınıf, olayları dinler ve onlara tepki verir. Bir abone, olay işleme yöntemi ekleyerek bir olayla ilgilendiğini belirtir. Yayıncı olayı tetiklediğinde, abonenin olay işleyici yöntemi çalışır. Tek bir olayın, olay gerçekleştiğinde her biri farklı şekilde yanıt veren birden fazla abonesi olabilir.

3. Delegeler

Delegeler, C#'da olayların temelidir. Yöntemlere tür güvenli işaretçilerdir ve tüm olay işleyicilerin uyması gereken sözleşmeyi tanımlar. Delegeler, yalnızca belirli bir imzaya sahip yöntemlerin olayı ele almasını sağlar ve tutarlı ve hatasız bir olay işleme mekanizması sunar.

4. Olay İşleyiciler

Olay işleyiciler, bir olay tetiklendiğinde çalıştırılan abone sınıfındaki yöntemlerdir. UI güncelleme, veri kaydetme veya hesaplama yapma gibi olayları ele almak için mantık içerirler. Bir olay işleyicinin imzası, olayla ilişkilendirilmiş delege türüne uygun olmalıdır. Ek olarak, diğer sınıflar da ortak olaylara tepki vermek için olay işleyicileri kullanabilir. Bu, olayların modüler ve yeniden kullanılabilir bir şekilde uygulanmasını kolaylaştırır.

5. Olay Verileri

Birçok durumda olayların abonelere ek bilgi iletmesi gerekir. Bu, temel EventArgs sınıfından türetilmiş olay veri sınıfları kullanılarak sağlanır. Olay verileri, bir mesaj, durum veya diğer ilgili bilgi gibi olayla ilgili ayrıntıları içerir.

Adım 1: Bir Delege İlan Et

Delegeler, olay işleyicilerinin yöntem imzalarını tanımlar. Bu örnekte, iki parametreli olay işleyiciyi temsil etmek için bir delege oluşturuyoruz: object sender ve EventArgs e.

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

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

Public Delegate Sub MyEventHandler(ByVal sender As Object, ByVal e As EventArgs)

Adım 2: Bir Olay İlan Et

Olaylar event anahtar sözcüğü kullanılarak beyan edilir ve delege türüne dayalıdır. İşte bir örnek:

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

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

Public Class Publisher
	Public Event Notify As MyEventHandler ' Declare the event.
End Class

Adım 3: Olayı Tetikle

Olay gerekli parametreleri ileterek delege çağrılarak tetiklenir.

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.
    }
}

Public Sub TriggerEvent()
	If Notify IsNot Nothing Then ' Check if there are subscribers.
		Notify(Me, EventArgs.Empty) ' Raise the event.
	End If
End Sub

Adım 4: Olay Aboneliğini Yap

Aboneler olay işleyicilerini += operatörünü kullanarak kaydederler:

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.

Dim publisher As New Publisher()
Dim subscriber As New Subscriber()
publisher.Notify += subscriber.OnNotify ' Subscribe to the event.

Adım 5: Olayı Ele Al

Bir olay işleyici, abone sınıfındaki delege imzasıyla eşleşen bir yöntemdir:

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

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

Public Sub OnNotify(ByVal sender As Object, ByVal e As EventArgs)
	Console.WriteLine("Event received!")
End Sub

IronPDF Nereye Uyar?

IronPDF, PDF'leri oluşturmanıza, değiştirmenize ve güvenli hale getirmenize olanak tanır ve olaylarla entegre edilmesi uygulamanızı daha etkileşimli hale getirebilir. Örneğin:

• İlerleme Takibi: Büyük bir PDF raporu oluştururken tamamlanma yüzdesini abonelere bildirin.
• Hata İşleme: PDF oluşturma veya kaydetme sırasında bir sorun ortaya çıkarsa bir olay tetikleyin.
• Özelleştirilmiş Eylemler: Belirli PDF işlemlerinden sonra kaydetme veya UI güncellemeleri gibi özelleştirilmiş mantıkları çalıştırın.

Örnek: Olay Bildirimleri ile PDF Oluşturma

IronPDF'i olaylarla kullanmanın gösterildiği basit bir örnek işte burada:

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}%");
    }
}

Imports IronPdf
Imports System

' Program class
Friend Class Program
	' Define a custom event for progress updates
	Public Shared Event ProgressUpdated As Action(Of Integer)

	Public Shared Sub Main()
		License.LicenseKey = "License-Key"
		' Subscribe to the ProgressUpdated event
		AddHandler Me.ProgressUpdated, AddressOf DisplayProgress

		Console.WriteLine("Generating PDF...")
		GeneratePdf() ' Generate the PDF
	End Sub

	' Method to generate PDF and trigger progress updates
	Private Shared Sub GeneratePdf()
		Try
			Dim Renderer = New ChromePdfRenderer()
			For i As Integer = 0 To 100 Step 20
				' Simulate progress
				System.Threading.Thread.Sleep(500)
				RaiseEvent ProgressUpdated(i)
			Next i
			' Generate a PDF
			Dim PdfDocument = Renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF with Events!</h1>")
			PdfDocument.SaveAs("IronPDF/example.pdf")
			RaiseEvent ProgressUpdated(100)
			Console.WriteLine("PDF generated successfully!")
		Catch ex As Exception
			Console.WriteLine($"Error: {ex.Message}")
		End Try
	End Sub

	' Event handler to display progress
	Private Shared Sub DisplayProgress(ByVal progress As Integer)
		Console.WriteLine($"Progress: {progress}%")
	End Sub
End Class