Saltar al pie de página
USANDO IRONPDF

Creación de un visor de PDF Telerik Blazor con IronPDF

Combine el componente de visualización de PDF pulido de Telerik UI con el motor de renderizado basado en Chrome de IronPDF para crear una solución PDF completa en Blazor. Esta configuración le permite generar archivos PDF dinámicos a partir de HTML y al mismo tiempo ofrecer a los usuarios funciones de visualización profesionales como controles de búsqueda, zoom y navegación.

Al crear aplicaciones Blazor modernas, a menudo son necesarias capacidades confiables de visualización de PDF. Si bien Telerik UI para Blazor ofrece un excelente componente de visualización de PDF, integrarlo con el eficaz motor de generación de IronPDF ofrece una solución completa para manejar documentos PDF en sus aplicaciones. Esta integración le permite crear archivos PDF a partir de HTML , convertir URL a PDF e incluso renderizar vistas CSHTML como PDF al tiempo que proporciona funciones de visualización profesionales.

¿Por qué combinar Telerik UI con IronPDF?

El visor de PDF Telerik Blazor destaca en la visualización de PDF con funciones como la búsqueda de texto, los controles de zoom y una barra de herramientas personalizable. Sin embargo, cuando necesite generar archivos PDF dinámicamente a partir de HTML, URL o vistas Razor, IronPDF proporciona el motor de renderizado basado en Chrome que Telerik UI no incluye en sus bibliotecas de procesamiento de documentos. El motor de renderizado Chrome de IronPDF garantiza una precisión de píxeles perfecta al convertir contenido web a PDF.

Este enfoque híbrido le permite utilizar las capacidades superiores de creación de PDF de IronPDF mientras utiliza los componentes de interfaz de usuario refinados de Telerik para la visualización. Es particularmente útil cuando necesita modernizar proyectos web heredados o crear nuevas soluciones Blazor PDF que requieren funciones de generación y visualización. Su simplicidad facilita la elección. También puedes agregar encabezados y pies de página , aplicar marcas de agua y configurar márgenes personalizados a tus PDF generados antes de mostrarlos.

¿Qué hace que esta integración sea valiosa?

La combinación aborda los requisitos comunes del flujo de trabajo de PDF: generar facturas, informes o documentación de forma dinámica y al mismo tiempo brindar a los usuarios controles familiares de visualización de PDF. IronPDF maneja escenarios de renderizado complejos que los convertidores básicos de HTML a PDF no pueden manejar, incluida la ejecución de JavaScript , la compatibilidad con CSS3 y la renderización de fuentes web , mientras que Telerik proporciona la interfaz profesional que los usuarios esperan. Este enfoque también admite UTF-8 e idiomas internacionales , lo que lo hace adecuado para aplicaciones globales.

¿Cuándo conviene utilizar ambas bibliotecas juntas?

Este enfoque funciona mejor para aplicaciones que necesitan tanto la generación como la visualización de PDF, como sistemas de gestión de documentos, paneles de informes o portales de clientes. Si sólo necesita mostrar archivos PDF existentes, Telerik es suficiente; Si solo necesita generación sin visualización, IronPDF solo funciona perfectamente. Para escenarios empresariales que requieren firmas digitales , conformidad con PDF/A o funciones de seguridad PDF , la combinación proporciona una funcionalidad completa.

¿Cómo se puede configurar un proyecto Blazor con ambas bibliotecas?

La instalación de ambas bibliotecas en su proyecto Blazor es sencilla. Primero, instale los paquetes necesarios a través de NuGet. Puede seguir la guía de instalación detallada o utilizar el administrador de paquetes NuGet :

Install-Package IronPDF Telerik.UI.for.Blazor

Tras la instalación, configura tu Program.cs para añadir servicios:

builder.Services.AddTelerikBlazor();
builder.Services.AddSingleton<ChromePdfRenderer>();
builder.Services.AddTelerikBlazor();
builder.Services.AddSingleton<ChromePdfRenderer>();
$vbLabelText   $csharpLabel

Esta configuración habilita tanto los componentes de Telerik UI para Blazor como las capacidades de renderizado de IronPDF en su aplicación. Los usuarios de la suite DevCraft que ya estén familiarizados con Telerik encontrarán esta integración sencilla. El resultado es un sistema totalmente configurado. Para escenarios más complejos, es posible que desees explorar la generación de PDF asincrónica o configuraciones de registro personalizadas .

¿Qué opciones de configuración debería considerar?

Más allá de la configuración básica, es posible que desees configurar las opciones de renderizado de IronPDF de forma global o configurar la inyección de dependencia para servicios de generación de PDF personalizados. Considere agregar configuración para compresión de PDF , tiempos de espera de renderizado usando retrasos WaitFor o administración de fuentes personalizadas según los requisitos de su aplicación. También puede configurar tamaños de papel personalizados y ajustes de orientación de página .

¿Cómo se gestiona la licencia para ambos productos?

Ambas bibliotecas requieren licencias comerciales para su uso en producción. Las licencias de IronPDF se basan en la cantidad de desarrolladores y la implementación, mientras que Telerik UI para Blazor generalmente viene como parte de los paquetes DevCraft . Asegúrese de tener la licencia adecuada para su escenario de implementación. Obtenga más información sobre las opciones de licencia de IronPDF y cómo aplicar claves de licencia en su aplicación. Para obtener orientación sobre la implementación, consulte nuestras guías para la implementación de Azure , la implementación de AWS o la implementación de Docker .

¿Cómo crear documentos PDF con IronPDF para su visualización?

IronPDF transforma el contenido HTML en archivos PDF que el visor de PDF Telerik puede mostrar. A continuación se explica cómo generar un PDF a partir de HTML y prepararlo para su visualización. También puedes convertir cadenas HTML a PDF , renderizar archivos HTML o incluso convertir Markdown a PDF :

@page "/generate-pdf"
@inject ChromePdfRenderer Renderer
@code {
    private byte[] pdfData;
    private async Task GeneratePDF()
    {
        // Create PDF from HTML content
        var pdf = await Renderer.RenderHtmlAsPdfAsync(@"
            <h1>Invoice Report</h1>
            <table>
                <tr><td>Item</td><td>Amount</td></tr>
                <tr><td>Service</td><td>$100</td></tr>
            </table>");
        // Convert to byte array for Telerik viewer
        pdfData = pdf.BinaryData;
    }
}
@page "/generate-pdf"
@inject ChromePdfRenderer Renderer
@code {
    private byte[] pdfData;
    private async Task GeneratePDF()
    {
        // Create PDF from HTML content
        var pdf = await Renderer.RenderHtmlAsPdfAsync(@"
            <h1>Invoice Report</h1>
            <table>
                <tr><td>Item</td><td>Amount</td></tr>
                <tr><td>Service</td><td>$100</td></tr>
            </table>");
        // Convert to byte array for Telerik viewer
        pdfData = pdf.BinaryData;
    }
}
$vbLabelText   $csharpLabel

Este código genera un documento PDF listo para su visualización. El motor de renderizado de IronPDF garantiza que su contenido HTML, CSS e incluso JavaScript se renderice perfectamente, manteniendo todo el formato cuando los usuarios lo visualizan a través del componente visor de PDF. También puede agregar imágenes a archivos PDF , incrustar imágenes desde Azure Blob Storage o convertir imágenes a PDF directamente.

La clase ChromePdfRenderer ofrece amplias opciones de personalización. Puede configurar el tamaño de página, los márgenes, los encabezados, los pies de página e incluso definir CSS personalizado para medios impresos: características que complementan perfectamente las capacidades de visualización de Telerik. Para escenarios avanzados, explore el control de saltos de página , la configuración de la ventana gráfica o la configuración de URL base para una carga adecuada de los activos.

¿Qué aspecto tiene el PDF generado?

El PDF generado tendrá un aspecto similar al siguiente:

Un visor de documentos PDF que muestra un informe de factura con una tabla que contiene las columnas de artículo e importe, y una entrada de servicio por $100, demostrando las capacidades de renderizado HTML a PDF de IronPDF con un formato limpio y un diseño profesional.

¿Qué elementos HTML se visualizan mejor?

IronPDF maneja elementos HTML estándar de manera excelente, incluidas tablas, imágenes y texto con estilo. Los diseños CSS complejos, flexbox y sistemas de cuadrícula se procesan como se espera. Para obtener mejores resultados, utilice consultas de medios CSS específicas de impresión para mejorar el diseño de su PDF. El renderizador admite gráficos SVG , CSS responsivo e incluso gráficos JavaScript . También puede renderizar contenido WebGL para necesidades de gráficos avanzados.

¿Cómo puedes personalizar la configuración de generación de PDF?

IronPDF ofrece una amplia personalización a través de ChromePdfRenderOptions , lo que le permite controlar la orientación de la página, el tamaño, los márgenes y la ejecución de JavaScript. También puede agregar marcas de agua , aplicar encabezados y pies de página y agregar números de página mediante programación antes de pasar el PDF al visor. Para organizar los documentos, considere agregar marcadores o crear una tabla de contenido .

¿Cómo se puede integrar el componente Blazor del visor de PDF de Telerik?

Una vez que haya generado su PDF con IronPDF, mostrarlo con el visor de PDF Telerik Blazor es sencillo. También puede explorar la visualización de PDF en aplicaciones MAUI para escenarios multiplataforma:

<TelerikPdfViewer Data="@pdfData"
                  Height="600px"
                  Zoom="1.0">
    <PdfViewerToolBar>
        <PdfViewerToolBarPagerTool />
        <PdfViewerToolBarZoomTool />
        <PdfViewerToolBarSearchTool />
        <PdfViewerToolBarDownloadTool />
    </PdfViewerToolBar>
</TelerikPdfViewer>
<TelerikPdfViewer Data="@pdfData"
                  Height="600px"
                  Zoom="1.0">
    <PdfViewerToolBar>
        <PdfViewerToolBarPagerTool />
        <PdfViewerToolBarZoomTool />
        <PdfViewerToolBarSearchTool />
        <PdfViewerToolBarDownloadTool />
    </PdfViewerToolBar>
</TelerikPdfViewer>
$vbLabelText   $csharpLabel

Esta configuración de componentes proporciona herramientas esenciales para interactuar con archivos PDF. La barra de herramientas incluye botones de navegación, controles de nivel de zoom y funciones de búsqueda. Puede personalizar qué herramientas aparecen en función de las necesidades de su aplicación. El atributo Data proporciona el valor PDF para mostrar. Para mejorar la funcionalidad, es posible que desee implementar extracción de texto , capacidades de búsqueda de PDF o funciones de anotación .

El visor de Telerik UI para Blazor gestiona automáticamente la compatibilidad con los navegadores y funciona en todos los navegadores modernos sin plugins. Para las aplicaciones de escritorio que utilizan .NET MAUI, ambas bibliotecas admiten la implementación multiplataforma, lo que le permite crear experiencias PDF coherentes en plataformas web y de escritorio. Esta funcionalidad es nativa del visor. También puede exportar archivos PDF a diferentes formatos o rasterizarlos en imágenes para obtener mayor flexibilidad.

¿Qué personalizaciones de la barra de herramientas están disponibles?

La barra de herramientas del visor de PDF de Telerik es altamente personalizable: puede agregar, eliminar o reordenar herramientas, crear botones personalizados e incluso crear barras de herramientas completamente personalizadas. Las personalizaciones comunes incluyen agregar botones de impresión, alternancias de pantalla completa o acciones específicas de la aplicación. También puede integrar la funcionalidad de impresión PDF o la capacidad de edición de formularios PDF en su barra de herramientas personalizada.

¿Cómo manejar archivos PDF grandes?

Para archivos PDF de gran tamaño, considere implementar la carga progresiva o la transmisión mediante flujos de memoria PDF . El visor Telerik admite la carga de archivos PDF desde URL, lo que puede ayudar con el rendimiento. También puede implementar el almacenamiento en caché del lado del servidor de los PDF generados para evitar la regeneración de documentos idénticos. Para optimizar, explore técnicas de compresión de PDF o linealización de PDF para una visualización web más rápida.

¿Cómo funcionan juntos estos componentes?

La integración crea un flujo de trabajo eficaz donde IronPDF se encarga del trabajo pesado de la creación de PDF mientras Telerik proporciona una experiencia de visualización refinada. A continuación se muestra un ejemplo completo que demuestra la creación de archivos PDF a partir de HTML con contenido dinámico:

@page "/document-viewer"
@inject ChromePdfRenderer Renderer
<div class="row">
    <div class="col-md-12">
        <TelerikButton OnClick="@LoadDocument">
            Load PDF Document
        </TelerikButton>
        @if (documentData != null)
        {
            <TelerikPdfViewer Data="@documentData"
                            Height="800px">
            </TelerikPdfViewer>
        }
    </div>
</div>
@code {
    private byte[] documentData;
    private async Task LoadDocument()
    {
        // Generate dynamic PDF content
        var html = await GenerateReportHtml();
        var pdf = await Renderer.RenderHtmlAsPdfAsync(html);
        documentData = pdf.BinaryData;
    }
    private async Task<string> GenerateReportHtml()
    {
        // Build your HTML dynamically
        return "<h1>Dynamic Report</h1><p>Report content here</p>";
    }
}
@page "/document-viewer"
@inject ChromePdfRenderer Renderer
<div class="row">
    <div class="col-md-12">
        <TelerikButton OnClick="@LoadDocument">
            Load PDF Document
        </TelerikButton>
        @if (documentData != null)
        {
            <TelerikPdfViewer Data="@documentData"
                            Height="800px">
            </TelerikPdfViewer>
        }
    </div>
</div>
@code {
    private byte[] documentData;
    private async Task LoadDocument()
    {
        // Generate dynamic PDF content
        var html = await GenerateReportHtml();
        var pdf = await Renderer.RenderHtmlAsPdfAsync(html);
        documentData = pdf.BinaryData;
    }
    private async Task<string> GenerateReportHtml()
    {
        // Build your HTML dynamically
        return "<h1>Dynamic Report</h1><p>Report content here</p>";
    }
}
$vbLabelText   $csharpLabel

¿Cómo es la solución integrada?

Una factura profesional en PDF mostrada en el Visor de PDF de Telerik Blazor muestra varias partidas, incluyendo servicios de consultoría y licencias de software por un total de $550, lo que demuestra la fluida integración entre las capacidades de generación de IronPDF y los componentes de visualización de Telerik con controles completos en la barra de herramientas.

Este patrón permite generar PDF a petición y mostrarlos inmediatamente. El componente se actualiza de forma reactiva cuando hay nuevos datos disponibles, lo que mejora significativamente la experiencia del usuario en comparación con los flujos de trabajo tradicionales de descargar y abrir. El evento OnClick activa el proceso de carga del documento. Puede mejorar esto aún más fusionando varios PDF , agregando archivos adjuntos o implementando el seguimiento de revisiones .

Para escenarios en los que necesita cargar archivos PDF existentes, IronPDF puede acceder a los objetos DOM del PDF y procesarlos antes de pasarlos al visor. Esto permite funciones como marcas de agua , manipulación de páginas o extracción de contenido antes de la visualización. Los usuarios avanzados también pueden implementar funciones de limpieza o redacción de PDF para documentos confidenciales.

¿Cómo puedes agregar funciones interactivas?

Más allá de la visualización básica, puede implementar funciones como completar formularios , firmas digitales o anotaciones procesando archivos PDF con IronPDF antes de mostrarlos. Esto le permite crear flujos de trabajo de documentos interactivos manteniendo la interfaz fácil de usar del visor Telerik. También puede crear formularios PDF mediante programación o agregar campos de firma para flujos de trabajo de firma electrónica.

¿Qué pasa con la optimización del rendimiento?

Considere implementar la generación de PDF en segundo plano utilizando servicios alojados o colas para documentos complejos. Almacene en caché los PDF a los que se accede con frecuencia y utilice compresión al almacenar o transmitir datos PDF para mejorar la capacidad de respuesta de la aplicación. Para escenarios de gran volumen, explore las opciones asincrónicas y de subprocesos múltiples o la generación de PDF en paralelo . También puedes mejorar la representación con retrasos de representación personalizados para contenido con mucho uso de JavaScript.

¿Por qué elegir este enfoque híbrido?

Aunque Telerik UI para Blazor ofrece excelentes capacidades de visualización, no iguala la potencia de generación de PDF de IronPDF. El motor basado en Chrome de IronPDF renderiza diseños complejos, formularios y contenido estilizado con los que las bibliotecas de procesamiento de documentos más sencillas podrían tener problemas. Al combinar ambos, obtendrá una generación de PDF profesional con una interfaz de visualización profesional. Este enfoque también admite funciones avanzadas como compatibilidad con PDF/A , accesibilidad a PDF/UA y gestión de metadatos .

Este enfoque proporciona flexibilidad a los desarrolladores que necesitan explorar diferentes opciones de visualización. Se podría sustituir el visor de Telerik por un visor iframe más sencillo o desarrollar componentes de visualización personalizados manteniendo las capacidades de generación de IronPDF. La solución se adapta bien a conversiones simples de HTML a PDF y escenarios de generación de informes complejos.

¿Cuáles son las consideraciones costo-beneficio?

Si bien el uso de dos bibliotecas comerciales aumenta los costos de licencia, el tiempo de desarrollo ahorrado y los resultados profesionales obtenidos a menudo justifican la inversión. Considere la alternativa de crear la generación y visualización de PDF desde cero: la solución combinada proporciona una funcionalidad inmediata y lista para producción. Ambas bibliotecas ofrecen una excelente documentación y IronPDF proporciona guías prácticas completas y ejemplos de código para acelerar el desarrollo.

¿Cómo se compara esto con otras soluciones?

Los enfoques alternativos, como usar solo bibliotecas de código abierto, a menudo requieren un mayor esfuerzo de desarrollo y pueden carecer de características o mejoras. Los servicios de PDF basados en la nube plantean problemas de latencia y privacidad de datos. Este enfoque híbrido mantiene todo en su aplicación y al mismo tiempo proporciona una funcionalidad líder. Para realizar comparaciones detalladas, vea cómo se compara IronPDF con las alternativas iText , Aspose o Syncfusion .

¿Cuáles son los próximos pasos para la implementación?

Crear un visor de PDF de Telerik Blazor con IronPDF le ofrece lo mejor de ambos mundos: generación de PDF efectiva y experiencias de visualización pulidas. Esta combinación le ayuda a crear soluciones PDF completas que pueden modernizar proyectos web heredados y cumplir con los requisitos de las aplicaciones modernas. Ya sea que trabaje con implementaciones de Windows , Linux o macOS , ambas bibliotecas brindan soporte multiplataforma.

Tanto si está creando sistemas de gestión de documentos, herramientas de generación de informes o cualquier aplicación de Blazor que necesite capacidades PDF, esta integración proporciona la funcionalidad y la experiencia de usuario que sus proyectos exigen. Desde la simple generación de facturas hasta complejas transformaciones de XML a PDF , la solución combinada maneja diversos requisitos de manera eficaz.

¿Listo para implementar esta solución? Comience su prueba gratuita de IronPDF para explorar cómo mejora su interfaz de usuario de Telerik para proyectos Blazor. Para uso en producción, consulte nuestras opciones de licencia para encontrar la que mejor se adapte a sus necesidades.

Preguntas Frecuentes

¿Qué es el visor de PDF Telerik Blazor?

Telerik Blazor PDF Viewer es un componente diseñado para mostrar documentos PDF directamente dentro de las aplicaciones Blazor, ofreciendo una experiencia de visualización fluida a los usuarios.

¿Cómo mejora IronPDF el visor de PDF Telerik Blazor?

IronPDF mejora el visor de PDF Telerik Blazor proporcionando sólidas capacidades de generación de PDF, lo que permite a los desarrolladores crear, modificar y gestionar documentos PDF de manera eficiente dentro de sus aplicaciones Blazor.

¿Por qué combinar IronPDF con Telerik UI para Blazor?

La combinación de IronPDF con Telerik UI para Blazor ofrece una solución completa para el manejo de archivos PDF, ya que IronPDF añade funciones avanzadas de generación y manipulación a las capacidades de visualización existentes de Telerik.

¿Puedo generar archivos PDF con IronPDF en una aplicación Blazor?

Sí, IronPDF permite generar PDF de alta calidad en aplicaciones Blazor, ofreciendo funciones como la conversión de HTML a PDF y opciones de personalización detalladas.

¿Cuáles son las ventajas de utilizar IronPDF para la gestión de PDF en las aplicaciones de Blazor?

IronPDF ofrece potentes funciones como la generación, conversión y edición de PDF, que mejoran la funcionalidad y flexibilidad del manejo de PDF en las aplicaciones de Blazor.

¿Es fácil integrar IronPDF con los componentes Blazor de Telerik?

Sí, IronPDF puede integrarse fácilmente con los componentes de Telerik Blazor para ampliar su funcionalidad, proporcionando una experiencia perfecta a los desarrolladores que crean aplicaciones Blazor.

¿Qué funciones ofrece IronPDF a los desarrolladores de Blazor?

IronPDF ofrece funciones como la conversión de HTML a PDF, la edición de PDF y la posibilidad de añadir encabezados, pies de página y marcas de agua, lo que lo convierte en una herramienta versátil para los desarrolladores de Blazor.

¿Cómo mejora IronPDF la experiencia del usuario en las aplicaciones de Blazor?

IronPDF mejora la experiencia del usuario al permitir sofisticadas funcionalidades de PDF, como la fácil generación, personalización e integración de documentos, lo que da lugar a aplicaciones más dinámicas y con mayor capacidad de respuesta.

¿Qué hace de IronPDF una solución PDF completa para aplicaciones Blazor?

IronPDF es una solución completa porque combina funciones de generación, conversión y edición que, cuando se utilizan junto con componentes Telerik, cubren todos los aspectos de la gestión de PDF en aplicaciones Blazor.

¿Puede IronPDF gestionar documentos PDF de gran tamaño en aplicaciones Blazor?

Sí, IronPDF está diseñado para gestionar eficazmente documentos PDF de gran tamaño, garantizando un rendimiento fluido y reduciendo los tiempos de carga en las aplicaciones de Blazor.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más