C# Eventualidades (Cómo Funciona para Desarrolladores)

1. Clase de editor

La clase publicadora es la fuente del evento. Es responsable de declarar el evento y activarlo cuando ocurra una acción o condición específica. Este proceso generalmente involucra un método manejador de eventos para determinar cuándo ocurre el evento. El publicador también utiliza un delegado de evento para definir la firma de los métodos que pueden manejar el evento. Por ejemplo, en una interfaz gráfica de usuario (GUI), un control de botón actúa como el publicador cuando activa un evento de "Click".

2. Clase de suscriptor

La clase suscriptora escucha los eventos y reacciona a ellos. Un suscriptor registra su interés en un evento adjuntando un método manejador de eventos al evento. Cuando el publicador activa el evento, el método manejador de eventos del suscriptor se ejecuta. Un solo evento puede tener múltiples suscriptores, cada uno respondiendo de manera diferente cuando ocurre el evento.

3. Delegados

Los delegados son la base de los eventos en C#. Son punteros seguros para tipos de métodos y definen el contrato que todos los manejadores de eventos deben seguir. Los delegados aseguran que solo los métodos con una firma específica puedan manejar el evento, proporcionando un mecanismo de manejo de eventos consistente y libre de errores.

4. Manejadores de eventos

Los manejadores de eventos son métodos en la clase suscriptora que se ejecutan cuando se activa un evento. Contienen la lógica para manejar el evento, como actualizar la interfaz de usuario, registrar datos o realizar cálculos. La firma de un manejador de eventos debe coincidir con el tipo de delegado asociado con el evento. Además, otras clases pueden usar manejadores de eventos para reaccionar a eventos compartidos. Facilita la implementación de eventos de manera modular y reutilizable.

5. Datos de eventos

En muchos casos, los eventos necesitan transmitir información adicional a los suscriptores. Esto se logra usando clases de datos del evento, que se derivan de la clase base EventArgs. Los datos del evento contienen detalles específicos sobre el evento, como un mensaje, estado u otra información relevante.

Paso 1: Declarar un delegado

Los delegados definen la firma del método para los manejadores de eventos. En este ejemplo, creamos un delegado para representar el manejador de eventos con dos parámetros: object sender y 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)

Paso 2: Declarar un evento

Los eventos se declaran usando la palabra clave event y se basan en el tipo de delegado. Aquí hay un ejemplo:

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

Paso 3: Lanzar el evento

El evento se activa llamando al delegado y pasando los parámetros necesarios.

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

Paso 4: Suscríbase al evento

Los suscriptores registran manejadores de eventos utilizando el operador +=:

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.

Paso 5: Gestionar el evento

Un manejador de eventos es un método en la clase suscriptora que coincide con la firma del delegado:

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

¿Cómo encaja IronPDF?

IronPDF te permite generar, modificar y asegurar PDFs, e integrarlo con eventos puede hacer que tu aplicación sea más interactiva. Por ejemplo:

• Seguimiento del Progreso: Notificar a los suscriptores sobre el porcentaje de finalización al generar un informe PDF grande.
• Manejo de Errores: Activar un evento si surge un problema durante el renderizado o guardado del PDF.
• Acciones Personalizadas: Ejecutar lógica personalizada, como registrar o actualizar la UI, después de operaciones PDF específicas.

Ejemplo: Generación de un PDF con notificaciones de eventos

Aquí hay un ejemplo simple para demostrar usar IronPDF con eventos:

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