Prism Logging (Cómo Funciona para Desarrolladores)

Introducción a Prism Logging

Prism.Plugin.Logging extiende Prism, un marco popular para construir aplicaciones XAML, proporcionando capacidades de registro completas. Con soporte para múltiples proveedores de registro como NLog, Serilog y Microsoft.Extensions.Logging, Prism.Plugin.Logging ofrece opciones de flexibilidad y personalización para adaptarse a diversos requisitos de aplicación.

Ventajas de utilizar Prism logging

Configuración de Registro Flexible: Prism.Plugin.Logging permite a los desarrolladores configurar varios proveedores de registro de manera fluida, incluyendo opciones populares como NLog, Serilog y Microsoft.Extensions.Logging.

Soporte de Registro Estructurado: Los desarrolladores pueden registrar datos estructurados con sus mensajes usando Prism.Plugin.Logging. Esta función es especialmente útil en escenarios que involucran aplicaciones de consola donde se debe registrar y agregar datos de contexto extensos, incluyendo marcas de tiempo, códigos de error o actividades de usuario a los informes de registro producidos por IronPDF.

Cómo utilizar Prism logging

1. Crea un nuevo proyecto C#
2. Instala el paquete de registro Prism.
3. Crea un objeto para el SyslogLogger y pasa la configuración como parámetro.
4. Llama al método de registro cuando sea necesario y pasa el mensaje de registro y el nivel de registro.
5. Desecha el objeto de registro al final.

Cómo empezar con Prism Logs

Crear un nuevo proyecto en Visual Studio

Elige el menú Archivo en la aplicación Visual Studio. Haz clic en "Nuevo Proyecto", luego elige "Aplicación de consola".

Ingresa el nombre del proyecto en el área de texto designada después de seleccionar la ubicación del archivo. Luego, como se muestra en el ejemplo a continuación, selecciona el .NET Framework necesario haciendo clic en el botón Crear.

La aplicación elegida determinará cómo está organizado el proyecto de Visual Studio. Simplemente abre el archivo program.cs para comenzar a agregar código a la aplicación y construirla. Puedes usar Windows, la consola o la aplicación web.

Después de esto, se puede agregar la biblioteca y probar el código.

using Prism.Logging.Syslog;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

class Program
{
    public class Demo
    {
        public string Name { get; set; }
        public int Age { get; set; }

        // Configure the logger options
        static Options genOptions = new Options
        {
            HostNameOrIp = "127.0.0.1",
            Port = 514,
            AppNameOrTag = "LoggingDemo"
        };

        static SyslogLogger logger = new SyslogLogger(genOptions);
        static IList<LogData> Loglst = new List<LogData>();

        static async Task Main(string[] args)
        {
            MessageLog("Application started.", Prism.Logging.Syslog.Level.Information);
            PerformApplicationLogic();
            MessageLog("Application stopped.", Prism.Logging.Syslog.Level.Information);
        }

        static void PerformApplicationLogic()
        {
            // Example application logic
            Console.WriteLine("Performing application logic...");

            // Simulate error
            try
            {
                throw new Exception("Simulated Exception");
            }
            catch (Exception ex)
            {
                MessageLog($"Error occurred: {ex.Message}", Prism.Logging.Syslog.Level.Error);
            }
        }

        // Logs messages and their levels
        static void MessageLog(string message, Prism.Logging.Syslog.Level level)
        {
            Loglst.Add(new LogData { Message = message, Level = level.ToString() });
            logger.Log(message, level);
        }

        public class LogData
        {
            public string Message { get; set; }
            public string Level { get; set; }
        }

        public class Options : ISyslogOptions
        {
            public string HostNameOrIp { get; set; }
            public int? Port { get; set; }
            public string AppNameOrTag { get; set; }
        }
    }
}

using Prism.Logging.Syslog;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

class Program
{
    public class Demo
    {
        public string Name { get; set; }
        public int Age { get; set; }

        // Configure the logger options
        static Options genOptions = new Options
        {
            HostNameOrIp = "127.0.0.1",
            Port = 514,
            AppNameOrTag = "LoggingDemo"
        };

        static SyslogLogger logger = new SyslogLogger(genOptions);
        static IList<LogData> Loglst = new List<LogData>();

        static async Task Main(string[] args)
        {
            MessageLog("Application started.", Prism.Logging.Syslog.Level.Information);
            PerformApplicationLogic();
            MessageLog("Application stopped.", Prism.Logging.Syslog.Level.Information);
        }

        static void PerformApplicationLogic()
        {
            // Example application logic
            Console.WriteLine("Performing application logic...");

            // Simulate error
            try
            {
                throw new Exception("Simulated Exception");
            }
            catch (Exception ex)
            {
                MessageLog($"Error occurred: {ex.Message}", Prism.Logging.Syslog.Level.Error);
            }
        }

        // Logs messages and their levels
        static void MessageLog(string message, Prism.Logging.Syslog.Level level)
        {
            Loglst.Add(new LogData { Message = message, Level = level.ToString() });
            logger.Log(message, level);
        }

        public class LogData
        {
            public string Message { get; set; }
            public string Level { get; set; }
        }

        public class Options : ISyslogOptions
        {
            public string HostNameOrIp { get; set; }
            public int? Port { get; set; }
            public string AppNameOrTag { get; set; }
        }
    }
}

static Options genOptions = new Options
{
    HostNameOrIp = "127.0.0.1",
    Port = 514,
    AppNameOrTag = "LoggingDemo"
};
static SyslogLogger logger = new SyslogLogger(genOptions);
logger.Log("Sample message", Prism.Logging.Syslog.Level.Information);

static Options genOptions = new Options
{
    HostNameOrIp = "127.0.0.1",
    Port = 514,
    AppNameOrTag = "LoggingDemo"
};
static SyslogLogger logger = new SyslogLogger(genOptions);
logger.Log("Sample message", Prism.Logging.Syslog.Level.Information);

Integración de Prism Logging y IronPDF

Instalar IronPDF

• Abre el proyecto de Visual Studio.

• Elija "Herramientas" > "Administrador de Paquetes NuGet" > "Consola del Administrador de Paquetes".

  • En la Consola del Administrador de Paquetes, escribe el siguiente comando y presiona Enter:

  Install-Package IronPdf

• Otra forma de instalar IronPDF es usando el Administrador de Paquetes NuGet para Soluciones.
• Busca el paquete IronPDF en los resultados de búsqueda, selecciónalo, luego haz clic en el botón "Instalar". Visual Studio manejará la descarga e instalación automáticamente.

• NuGet descargará e instalará el paquete IronPDF y cualquier dependencia requerida para tu proyecto.
• Una vez que IronPDF ha sido instalado, puedes usarlo para tu proyecto.

Implementación de la lógica

• Configuración del Renderizador y Registrador: El software configura el renderizador de IronPDF y el registrador de Prism.
• Registro de mensajes: los mensajes con una categoría y prioridad designadas se pueden registrar utilizando el método MessageLog() . En este ejemplo, registramos los mensajes de inicio y parada de la aplicación, así como cualquier excepción que surja mientras la aplicación se está ejecutando.
• Aplicación de Lógica: Una parte de la lógica de la aplicación se simula con el método PerformApplicationLogic(). Para ilustrar el registro de errores, simplemente produce un mensaje y genera una excepción en este caso.
• Creación de un Informe de Registro en PDF: Después de la ejecución de la lógica de la aplicación, el software crea un documento HTML basado en los mensajes registrados. Luego utiliza la característica de RenderHtmlAsPdf() de IronPDF para transformar el documento HTML en un archivo de registro como informe en PDF. El archivo PDF se guarda luego en el disco.

Extender el código previamente definido para integrar el código de IronPDF:

using IronPdf;

static void GeneratePdfLogReport()
{
    var renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

    // Generate HTML content for PDF report
    string htmlContent = "<h1>Log Report</h1><ul>";
    foreach (var log in Loglst)
    {
        htmlContent += $"<li><strong>Message: {log.Message}</strong> Level: {log.Level}</li>";
    }
    htmlContent += "</ul>";

    // Generate PDF document
    var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

    // Save PDF file
    string filePath = "log_report.pdf";
    pdfDocument.SaveAs(filePath);
    Console.WriteLine($"PDF log report generated: {filePath}");
}

using IronPdf;

static void GeneratePdfLogReport()
{
    var renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

    // Generate HTML content for PDF report
    string htmlContent = "<h1>Log Report</h1><ul>";
    foreach (var log in Loglst)
    {
        htmlContent += $"<li><strong>Message: {log.Message}</strong> Level: {log.Level}</li>";
    }
    htmlContent += "</ul>";

    // Generate PDF document
    var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

    // Save PDF file
    string filePath = "log_report.pdf";
    pdfDocument.SaveAs(filePath);
    Console.WriteLine($"PDF log report generated: {filePath}");
}

Informe de registro de imagen generado por IronPDF:

Para obtener más información sobre los referencias del código de IronPDF consulta aquí.

Conclusión

La integración de Prism.Plugin.Logging con IronPDF permite a los desarrolladores incorporar fácilmente una capacidad de registro extensiva en aplicaciones de terminal. Los desarrolladores pueden mejorar el mantenimiento general del programa, optimizar las capacidades de depuración y acelerar las operaciones de registro utilizando las características de ambas herramientas. Prism.Plugin.Logging permite que las aplicaciones de consola obtengan cobertura completa de registro, garantizando capacidades fuertes de monitoreo y solución de problemas, con la implementación y configuración adecuadas.

IronPDF ofrece una licencia perpetua de un paquete Lite que incluye una licencia permanente, un año de mantenimiento de software y una actualización de la biblioteca. IronPDF ofrece licencias gratuitas para fines de desarrollo, sujetas a restricciones de tiempo y redistribución. Para adquirir la prueba gratuita. Para obtener más información sobre los diversos productos de Iron Software, visita su enlace página web aquí.