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 controlador 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);

Paso 2: Declarar un evento

Los eventos se declaran utilizando 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.
}

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

Paso 4: Suscríbase al evento

Los suscriptores registran controladores 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.

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

¿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: notifique a los suscriptores sobre el porcentaje de finalización al generar un informe PDF grande.
• Manejo de errores: activa un evento si surge un problema durante la representación o el guardado de PDF.
• Acciones personalizadas: ejecuta lógica personalizada, como registro o actualizaciones de la interfaz de usuario, 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}%");
    }
}