PostSharp C# (Cómo Funciona para Desarrolladores)

Crear un proyecto de consola en Visual Studio es sencillo. Siga estos pasos para iniciar una Aplicación de Consola en el entorno de Visual Studio:

Asegúrese de que Visual Studio esté instalado en su computadora.

Iniciar un nuevo proyecto

Seleccione "Nuevo" en el menú Archivo, luego elija "Proyecto".

La plantilla "Aplicación de Consola" o "Aplicación de Consola (.NET Core)" está disponible para seleccionarse de la lista de referencias de plantillas de proyecto.

Introduzca un nombre para su proyecto en la sección "Nombre".

Seleccione una ubicación para el almacenamiento del proyecto.

Haga clic en "Crear" para iniciar el proyecto de la aplicación de consola.

Instalar PostSharp

PostSharp se puede instalar a través de la Consola del Administrador de Paquetes:

Install-Package PostSharp

Crear un aspecto PostSharp

Para definir su aspecto, agregue un nuevo archivo de clase C# a su proyecto. Al derivar de uno de los OnMethodBoundaryAspect, MethodInterceptionAspect, u otras clases base de aspecto apropiadas, puede implementar su atributo o aspecto personalizado. Aquí hay una ilustración de un aspecto básico de registro OnMethodBoundaryAspect:

using PostSharp.Aspects;
using System;

// Define a logging aspect using OnMethodBoundaryAspect
[Serializable]
public class LoggingAspect : OnMethodBoundaryAspect
{
    // Executed before the method is invoked
    public override void OnEntry(MethodExecutionArgs args)
    {
        Console.WriteLine($"Entering method {args.Method.Name}.");
    }

    // Executed after the method has completed execution, both on success and failure
    public override void OnExit(MethodExecutionArgs args)
    {
        Console.WriteLine($"Exiting method {args.Method.Name}.");
    }

    // Executed when the method throws an exception
    public override void OnException(MethodExecutionArgs args)
    {
        Console.WriteLine($"Exception in method {args.Method.Name}: {args.Exception.Message}");
    }
}

using PostSharp.Aspects;
using System;

// Define a logging aspect using OnMethodBoundaryAspect
[Serializable]
public class LoggingAspect : OnMethodBoundaryAspect
{
    // Executed before the method is invoked
    public override void OnEntry(MethodExecutionArgs args)
    {
        Console.WriteLine($"Entering method {args.Method.Name}.");
    }

    // Executed after the method has completed execution, both on success and failure
    public override void OnExit(MethodExecutionArgs args)
    {
        Console.WriteLine($"Exiting method {args.Method.Name}.");
    }

    // Executed when the method throws an exception
    public override void OnException(MethodExecutionArgs args)
    {
        Console.WriteLine($"Exception in method {args.Method.Name}: {args.Exception.Message}");
    }
}

Modifique el comportamiento del aspecto según sus necesidades; por ejemplo, registre parámetros de métodos o valores de retorno.

Aplica el Aspecto

Para aplicar su recién definido aspecto, úse en métodos o clases donde desee que el comportamiento transversal sea activado. Utilice el atributo [LoggingAspect] en el código de registro de su método o clase de destino.

public class ExampleService
{
    [LoggingAspect]
    public void DoSomething()
    {
        Console.WriteLine("Doing something...");
    }
}

public class ExampleService
{
    [LoggingAspect]
    public void DoSomething()
    {
        Console.WriteLine("Doing something...");
    }
}

Configurar PostSharp (Opcional)

Para personalizar su funcionalidad y facilitar la integración con otros programas, PostSharp proporciona una variedad de opciones de configuración. Típicamente, la configuración se realiza mediante atributos, archivos XML o de manera programática.

Configurar el Registro: Use atributos o configuración XML para especificar los niveles de registro, los destinos de registro y otros parámetros de registro.

Optimización del Rendimiento: Modifique los parámetros de tejido y compilación de PostSharp para maximizar la eficiencia.

¿Qué es IronPDF - The .NET PDF Library?

IronPDF es una biblioteca .NET utilizada para crear, leer, editar y convertir archivos PDF. Proporciona a los desarrolladores una herramienta robusta y fácil de usar para trabajar con archivos PDF en aplicaciones C# o VB.NET. A continuación se presenta una descripción detallada de las características y capacidades de IronPDF:

Características de IronPDF

Generación de PDF desde HTML Convertir HTML, CSS y JavaScript a PDF. Soporta estándares web modernos como consultas de medios y diseño responsivo. Útil para crear facturas, informes y documentos PDF con estilo dinámico usando HTML y CSS.

Edición de PDF Puede agregar texto, imágenes y otro contenido a PDFs existentes. Extraer texto e imágenes de archivos PDF. Combine varios PDFs en un solo archivo. Divida los PDFs para crear varios documentos. Agregar encabezados, pies de página, anotaciones y marcas de agua.

Conversión de PDF Convierta diferentes formatos de archivo, incluidos Word, Excel e imágenes, a PDF, y también convierta PDFs a imágenes (PNG, JPEG, etc.).

Rendimiento y Confiabilidad Diseñado para alto rendimiento y confiabilidad en entornos industriales. Maneja eficazmente documentos grandes.

Instalar IronPDF

Instale el paquete IronPDF para obtener las herramientas que necesita para trabajar con PDFs en aplicaciones .NET:

Install-Package IronPdf

Defina el aspecto

En su proyecto, agregue un nuevo archivo de clase C# llamado PdfGenerationAspect.cs (o un nombre apropiado). Al heredar de OnMethodBoundaryAspect, puede implementar el aspecto para ejecutar el código antes y después de que se llame a un método:

using PostSharp.Aspects;
using IronPdf;
using System;

// Define a PDF generation aspect using OnMethodBoundaryAspect
[Serializable]
public class PdfGenerationAspect : OnMethodBoundaryAspect
{
    // Executed before the method invocation
    public override void OnEntry(MethodExecutionArgs args)
    {
        Console.WriteLine($"Generating PDF for method {args.Method.Name}.");
    }

    // Executed upon the successful completion of the method
    public override void OnSuccess(MethodExecutionArgs args)
    {
        var htmlContent = args.Arguments.GetArgument(0) as string;
        var outputPath = args.Arguments.GetArgument(1) as string;

        // Create an instance of HtmlToPdf class
        var Renderer = new HtmlToPdf();

        // Convert HTML content to PDF
        var pdf = Renderer.RenderHtmlAsPdf(htmlContent);

        // Save the generated PDF to the specified path
        pdf.SaveAs(outputPath);

        Console.WriteLine($"PDF generated successfully at {outputPath}.");
    }

    // Executed when the method throws an exception
    public override void OnException(MethodExecutionArgs args)
    {
        Console.WriteLine($"Exception occurred in method {args.Method.Name}: {args.Exception.Message}");
    }
}

using PostSharp.Aspects;
using IronPdf;
using System;

// Define a PDF generation aspect using OnMethodBoundaryAspect
[Serializable]
public class PdfGenerationAspect : OnMethodBoundaryAspect
{
    // Executed before the method invocation
    public override void OnEntry(MethodExecutionArgs args)
    {
        Console.WriteLine($"Generating PDF for method {args.Method.Name}.");
    }

    // Executed upon the successful completion of the method
    public override void OnSuccess(MethodExecutionArgs args)
    {
        var htmlContent = args.Arguments.GetArgument(0) as string;
        var outputPath = args.Arguments.GetArgument(1) as string;

        // Create an instance of HtmlToPdf class
        var Renderer = new HtmlToPdf();

        // Convert HTML content to PDF
        var pdf = Renderer.RenderHtmlAsPdf(htmlContent);

        // Save the generated PDF to the specified path
        pdf.SaveAs(outputPath);

        Console.WriteLine($"PDF generated successfully at {outputPath}.");
    }

    // Executed when the method throws an exception
    public override void OnException(MethodExecutionArgs args)
    {
        Console.WriteLine($"Exception occurred in method {args.Method.Name}: {args.Exception.Message}");
    }
}

Este aspecto maneja la creación exitosa de PDFs (OnSuccess), registra el inicio de la generación de PDF (OnEntry) y registra cualquier excepción (OnException).

Agregue el aspecto PdfGenerationAspect a una función que utilice IronPDF para crear PDFs. Defina una clase con un método para la generación de PDF:

public class PdfService
{
    [PdfGenerationAspect] // Apply the PdfGenerationAspect here
    public void GeneratePdf(string htmlContent, string outputPath)
    {
        // Create an instance of HtmlToPdf class
        var Renderer = new HtmlToPdf();

        // Convert HTML content to PDF
        var pdf = Renderer.RenderHtmlAsPdf(htmlContent);

        // Save the generated PDF to the specified path
        pdf.SaveAs(outputPath);
    }
}

public class PdfService
{
    [PdfGenerationAspect] // Apply the PdfGenerationAspect here
    public void GeneratePdf(string htmlContent, string outputPath)
    {
        // Create an instance of HtmlToPdf class
        var Renderer = new HtmlToPdf();

        // Convert HTML content to PDF
        var pdf = Renderer.RenderHtmlAsPdf(htmlContent);

        // Save the generated PDF to the specified path
        pdf.SaveAs(outputPath);
    }
}

Asegúrese de que la ubicación desde la que escribe o pretende invocar el método generación de HTML a PDF usando las mejores prácticas de IronPDF pueda acceder a la clase PdfService.

Ahora, cree PDFs con el aspecto aplicado usando la clase PdfService. Cree una instancia de PdfService en su aplicación principal u otra clase, y use la función GeneratePdf con el contenido HTML correcto y la ruta de salida. La clase de aspecto (PdfGenerationAspect) manejará cualquier excepción que surja durante la generación de PDF, registrará los mensajes relevantes e interceptará las llamadas a métodos cuando se ejecuten.

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of PdfService
        var pdfService = new PdfService();

        // Define HTML content and output PDF path
        string htmlContent = "<h1>Hello World</h1>";
        string outputPath = "hello_world.pdf";

        // Invoke PDF generation
        pdfService.GeneratePdf(htmlContent, outputPath);
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of PdfService
        var pdfService = new PdfService();

        // Define HTML content and output PDF path
        string htmlContent = "<h1>Hello World</h1>";
        string outputPath = "hello_world.pdf";

        // Invoke PDF generation
        pdfService.GeneratePdf(htmlContent, outputPath);
    }
}