Eventos en C# son una parte fundamental de la programación orientada a eventos. Permiten que los objetos se comuniquen y notifiquen a otros cuando algo de interés ocurre. En esta guía, exploraremos los eventos y cómo declararlos y utilizarlos. Vamos a desglosarlo paso a paso para asegurar una comprensión clara. También exploraremos IronPDF para operaciones PDF en aplicaciones C#.
Los eventos en C# permiten la comunicación entre objetos. Cuando se activa un evento, otros objetos pueden responder a él. Los eventos se basan en delegados, que actúan como punteros seguros para tipos de métodos. Un tipo de delegado de evento define la firma de los métodos que pueden manejar el evento público, asegurando la consistencia en el manejo de datos del evento.
Para comprender completamente los eventos, veamos sus componentes principales:
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".
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.
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.
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.
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.
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 Sub MyEventHandler(ByVal sender As Object, ByVal e As EventArgs)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 Notify As MyEventHandler ' Declare the event.
End ClassEl 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 Sub TriggerEvent()
If Notify IsNot Nothing Then ' Check if there are subscribers.
Notify(Me, EventArgs.Empty) ' Raise the event.
End If
End SubLos suscriptores registran controladores de eventos utilizando el operador +=:
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.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 Sub OnNotify(ByVal sender As Object, ByVal e As EventArgs)
Console.WriteLine("Event received!")
End SubIronPDF, una biblioteca versátil para trabajar con PDFs en .NET, se integra perfectamente con aplicaciones C#. Combinado con eventos en C#, puede proporcionar una forma dinámica de gestionar escenarios en tiempo real como actualizaciones de progreso, manejo de errores o notificaciones durante la generación de PDF o manipulación. Exploremos esta relación de manera atractiva. En C#, los eventos son una forma de señalar que algo ha sucedido. Permiten que una parte de tu programa notifique a otras partes sobre ocurrencias específicas, como si se estuviera procesando un archivo, una tarea completada o un error encontrado.
IronPDF te permite generar, modificar y asegurar PDFs, e integrarlo con eventos puede hacer que tu aplicación sea más interactiva. Por ejemplo:
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}%");
}
}Imports IronPdf
Imports System
' Program class
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 ProgressUpdated, AddressOf DisplayProgress
Console.WriteLine("Generating PDF...")
GeneratePdf() ' Generate the PDF
End Sub
' Method to generate PDF and trigger progress updates
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) ' Trigger event with progress value
Next
' Generate a PDF
Dim PdfDocument = Renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF with Events!</h1>")
PdfDocument.SaveAs("IronPDF/example.pdf")
RaiseEvent ProgressUpdated(100) ' Final update
Console.WriteLine("PDF generated successfully!")
Catch ex As Exception
Console.WriteLine($"Error: {ex.Message}")
End Try
End Sub
' Event handler to display progress
Shared Sub DisplayProgress(progress As Integer)
Console.WriteLine($"Progress: {progress}%")
End Sub
End Class
Los eventos en C# cuando se combinan con IronPDF crean un poderoso sistema para generación y gestión dinámica de PDFs. Los eventos proporcionan una forma limpia y eficiente de manejar operaciones PDF de manera asíncrona, mientras que IronPDF ofrece robustez funcional para la creación, edición y manipulación de PDFs en plataformas .NET. IronPDF ofrece una prueba gratuita para probar todas las funciones sin limitaciones. Las licencias comerciales comienzan en $999 y brindan acceso a la suite completa de capacidades de generación y procesamiento de PDF.
Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.
IronPDF es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesitas que tu PDF se parezca al HTML, rápido.
