Ícono de mensaje
Saltar al pie de página
  1. IronPDF
  2. Blog de IronPDF
  3. Cómo Usar IronPDF
  4. Mostrar PDFs en el Visor de PDF de ASP.NET
USANDO IRONPDF

Cómo mostrar, guardar e imprimir PDFs en un visor de ASP.NET Core

Curtis Chau
Curtis Chau
Publicado:

Cómo mostrar, guardar e imprimir archivos PDF en un visor ASP.NET Core

Mostrar documentos PDF directamente en navegadores web se ha convertido en un requisito esencial para las aplicaciones web modernas de ASP.NET Core. Ya sea que estés generando facturas, informes o contratos, los usuarios esperan una visualización de PDF sin problemas sin necesidad de descargar archivos PDF o instalar Adobe Acrobat Reader u otros complementos. Este tutorial demuestra cómo IronPDF simplifica la visualización, guardado e impresión de archivos PDF en tu visor de PDF de ASP.NET Core a través de su potente motor de renderizado basado en Chrome.

¿Cómo manejan los navegadores la visualización de PDF en ASP.NET Core?

Los navegadores modernos incluyen visores de PDF integrados que se activan cuando reciben un archivo PDF con el tipo MIME correcto (application/pdf). Cuando tu aplicación web ASP.NET Core devuelve un documento PDF con los encabezados apropiados, el navegador lo muestra automáticamente en línea. Esto elimina la necesidad de complementos externos, Adobe Acrobat Reader o bibliotecas complejas de JavaScript. Según MDN Web Docs, la configuración adecuada de encabezados es esencial para controlar cómo los navegadores manejan las descargas y visualizaciones de archivos.

IronPDF aprovecha esta capacidad del navegador generando archivos PDF de alta calidad en el servidor usando su clase ChromePdfRenderer. El renderizador usa un motor completo de Chrome bajo el capó, asegurando que tus documentos PDF se muestren exactamente como se preveía con soporte completo para CSS moderno, JavaScript, firmas digitales y fuentes web. A diferencia de los visores de documentos simples, IronPDF proporciona un control completo sobre el procesamiento y renderizado de PDF.

¿Qué herramientas necesita para visualizar archivos PDF en ASP.NET Core?

Configurar IronPDF en tu proyecto de visor de PDF de ASP.NET Core requiere solo unos pocos pasos. Primero, crea un nuevo proyecto en Visual Studio o vía la línea de comandos. Abre Visual Studio y selecciona la plantilla de proyecto de Aplicación Web de ASP.NET Core:

dotnet new mvc -n PdfViewerApp
cd PdfViewerApp
dotnet new mvc -n PdfViewerApp
cd PdfViewerApp
SHELL

Instalación del paquete IronPDF .NET

Instala IronPDF a través del Administrador de Paquetes NuGet en tu proyecto .NET:

Install-Package IronPdf

O en el Explorador de Soluciones, haz clic derecho en tu proyecto y selecciona "Administrar Paquetes NuGet." Elige la fuente de paquete apropiada y busca IronPDF.

Eso es todo el ajuste requerido. IronPDF funciona sin problemas con ASP.NET Core 3.1 y posteriores (versiones con soporte a largo plazo), incluyendo .NET 6, 7 y 8. La biblioteca se actualiza frecuentemente para asegurar la compatibilidad con los frameworks más recientes. Para instrucciones detalladas de instalación y más información, visita la guía de instalación de IronPDF. El paquete incluye todos los componentes necesarios para la generación, edición y procesamiento de PDF.

¿Cómo mostrar archivos PDF en el navegador con ASP.NET Core?

Crear y mostrar archivos PDF en el navegador requiere solo unas pocas líneas de código. Aquí hay una acción de controlador completa que genera un documento PDF a partir de HTML y lo muestra en línea. Este fragmento de código demuestra la funcionalidad central:

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class PdfController : Controller
{
    public IActionResult ViewPdf()
    {
        var renderer = new ChromePdfRenderer();
        // Configure rendering options for the PDF viewer
        renderer.RenderingOptions.PrintHtmlBackgrounds = true;
        renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
        renderer.RenderingOptions.EnableJavaScript = true;
        // Generate PDF from HTML string
        var html = @"
            <html>
            <head>
                <style>
                    body { font-family: Arial, sans-serif; padding: 20px; }
                    h1 { color: #2c3e50; }
                    .content { line-height: 1.6; width: 100%; }
                </style>
            </head>
            <body>
                <h1>Invoice #12345</h1>
                <div class='content'>
                    <p>Date: " + DateTime.Now.ToString("yyyy-MM-dd") + @"</p>
                    <p>Thank you for your business!</p>
                </div>
            </body>
            </html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        // Return PDF for inline viewing in the browser
        return File(pdf.BinaryData, "application/pdf");
    }
}
using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class PdfController : Controller
{
    public IActionResult ViewPdf()
    {
        var renderer = new ChromePdfRenderer();
        // Configure rendering options for the PDF viewer
        renderer.RenderingOptions.PrintHtmlBackgrounds = true;
        renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
        renderer.RenderingOptions.EnableJavaScript = true;
        // Generate PDF from HTML string
        var html = @"
            <html>
            <head>
                <style>
                    body { font-family: Arial, sans-serif; padding: 20px; }
                    h1 { color: #2c3e50; }
                    .content { line-height: 1.6; width: 100%; }
                </style>
            </head>
            <body>
                <h1>Invoice #12345</h1>
                <div class='content'>
                    <p>Date: " + DateTime.Now.ToString("yyyy-MM-dd") + @"</p>
                    <p>Thank you for your business!</p>
                </div>
            </body>
            </html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        // Return PDF for inline viewing in the browser
        return File(pdf.BinaryData, "application/pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

El código anterior crea una instancia de ChromePdfRenderer y la configura para incluir colores de fondo y convertir formularios HTML en formularios PDF. El método RenderHtmlAsPdf transforma la cadena HTML en un archivo PDF. El siguiente código muestra cómo devolver el PDF con el tipo MIME application/pdf le indica al navegador que lo muestre en línea en lugar de descargarlo. Este enfoque del lado del servidor asegura una representación consistente en todos los navegadores y plataformas.

Resultado

Cómo Mostrar, Guardar e Imprimir PDFs en un Visor ASP.NET Core: Figura 5 - Salida PDF

Para archivos HTML existentes o páginas Razor, puedes usar métodos alternativos de renderizado para ver el contenido PDF:

// Render from URL - useful for complex pages
var pdf = renderer.RenderUrlAsPdf("https://example.com/invoice");
// Render from HTML file in the same location
var pdf = renderer.RenderHtmlFileAsPdf("Views/Invoice.html");
// Render from wwwroot folder
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report.html");
// Render from URL - useful for complex pages
var pdf = renderer.RenderUrlAsPdf("https://example.com/invoice");
// Render from HTML file in the same location
var pdf = renderer.RenderHtmlFileAsPdf("Views/Invoice.html");
// Render from wwwroot folder
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report.html");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Estos métodos brindan flexibilidad en cómo se origina tu contenido HTML mientras se mantiene la misma salida de renderizado de PDF de alta calidad. También puedes cargar documentos PDF existentes, editar archivos PDF e incluso trabajar con formatos de Word (archivos DOCX) y Excel usando las características completas de IronPDF. Conoce más sobre las opciones de conversión de HTML a PDF en la documentación. Para capacidades avanzadas de procesamiento y edición, consulta la referencia de la API.

¿Cómo guardan los usuarios documentos PDF desde el navegador?

Para permitir a los usuarios descargar archivos PDF en lugar de verlos en línea, modifica el encabezado Content-Disposition. Esta característica es esencial para aplicaciones web donde los usuarios necesitan guardar documentos para acceso sin conexión:

public IActionResult DownloadPdf()
{
    var renderer = new ChromePdfRenderer();
    // Create PDF with CSS styling and images
    var html = @"<h1>Download Me</h1>
                 <img src='logo.png' width='100' />";
    var pdf = renderer.RenderHtmlAsPdf(html, @"wwwroot/images");
    // Force download with custom filename
    return File(pdf.BinaryData, "application/pdf", "invoice-2024.pdf");
}
public IActionResult DownloadPdf()
{
    var renderer = new ChromePdfRenderer();
    // Create PDF with CSS styling and images
    var html = @"<h1>Download Me</h1>
                 <img src='logo.png' width='100' />";
    var pdf = renderer.RenderHtmlAsPdf(html, @"wwwroot/images");
    // Force download with custom filename
    return File(pdf.BinaryData, "application/pdf", "invoice-2024.pdf");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Agregar el parámetro de nombre de archivo automáticamente establece el encabezado Content-Disposition en "attachment," solicitando al navegador descargar el archivo. Los usuarios también pueden guardar archivos PDF mostrados en línea usando la funcionalidad de guardar incorporada del navegador, accesible a través de Ctrl+S o la barra de herramientas del visor de PDF del navegador. El comportamiento predeterminado permite a los usuarios elegir su ubicación preferida de carpeta.

Resultado

Cómo Mostrar, Guardar e Imprimir PDFs en un Visor ASP.NET Core: Figura 6 - Salida de PDF del Navegador

Para una mejor eficiencia de memoria al manejar documentos PDF grandes, usa flujos:

public IActionResult StreamPdf()
{
    var renderer = new ChromePdfRenderer();
    // Load and process HTML with images
    var html = "<h1>Streamed Content</h1>";
    var pdf = renderer.RenderHtmlAsPdf(html);
    // Stream the PDF file to the browser
    var stream = pdf.Stream;
    stream.Position = 0;
    return File(stream, "application/pdf", "document.pdf");
}
public IActionResult StreamPdf()
{
    var renderer = new ChromePdfRenderer();
    // Load and process HTML with images
    var html = "<h1>Streamed Content</h1>";
    var pdf = renderer.RenderHtmlAsPdf(html);
    // Stream the PDF file to the browser
    var stream = pdf.Stream;
    stream.Position = 0;
    return File(stream, "application/pdf", "document.pdf");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Este enfoque reduce el consumo de memoria transmitiendo el archivo PDF directamente a la respuesta sin crear arreglos de bytes intermedios. El código anterior demuestra un manejo eficiente de archivos para documentos grandes. También puedes cargar archivos PDF existentes desde la carpeta wwwroot u otros lugares, editarlos y transmitir las versiones modificadas. Para una manipulación más avanzada de documentos PDF y procesamiento de imágenes, explora la referencia API de PdfDocument. El componente admite varias operaciones de edición incluyendo selección de texto, relleno de formularios y adición de firmas digitales.

¿Pueden los usuarios imprimir documentos PDF directamente desde aplicaciones web ASP.NET Core?

IronPDF optimiza los archivos PDF para impresión configurando el tipo de medio CSS apropiado y los ajustes de página. Esta característica asegura una salida profesional ya sea que los usuarios impriman en impresoras físicas o guarden como PDF:

public IActionResult PrintablePdf()
{
    var renderer = new ChromePdfRenderer();
    // Configure printing options for the PDF viewer
    renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
    renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
    renderer.RenderingOptions.MarginTop = 25;
    renderer.RenderingOptions.MarginBottom = 25;
    renderer.RenderingOptions.MarginLeft = 25;
    renderer.RenderingOptions.MarginRight = 25;
    // Load HTML with print-specific CSS
    var html = @"<h1>Print-Optimized Document</h1>
                 <p>This document is optimized for printing.</p>";
    var pdf = renderer.RenderHtmlAsPdf(html);
    // Return the PDF file for viewing and printing
    return File(pdf.BinaryData, "application/pdf");
}
public IActionResult PrintablePdf()
{
    var renderer = new ChromePdfRenderer();
    // Configure printing options for the PDF viewer
    renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
    renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
    renderer.RenderingOptions.MarginTop = 25;
    renderer.RenderingOptions.MarginBottom = 25;
    renderer.RenderingOptions.MarginLeft = 25;
    renderer.RenderingOptions.MarginRight = 25;
    // Load HTML with print-specific CSS
    var html = @"<h1>Print-Optimized Document</h1>
                 <p>This document is optimized for printing.</p>";
    var pdf = renderer.RenderHtmlAsPdf(html);
    // Return the PDF file for viewing and printing
    return File(pdf.BinaryData, "application/pdf");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Configurar CssMediaType a Print aplica estilos CSS específicos para impresión, asegurando que el documento PDF se vea correcto cuando se imprima. Los ajustes de margen proporcionan un espacio adecuado para el papel físico. El siguiente código muestra cómo los usuarios pueden imprimir archivos PDF directamente desde el visor de PDF del navegador usando el cuadro de diálogo de impresión estándar, manteniendo un control total sobre la selección y configuración de la impresora. Conoce más sobre las opciones de renderizado de PDF para ajustar tu salida. El componente de visualización de PDF maneja automáticamente todos los detalles de la impresión.

Cómo Mostrar, Guardar e Imprimir PDFs en un Visor ASP.NET Core: Figura 7 - Salida de Impresión de PDF

Soporte multiplataforma y de contenedores

IronPDF funciona sin problemas en Windows, Linux, macOS, contenedores de Docker y plataformas en la nube como Azure y AWS. Esta compatibilidad cruzada de plataforma asegura que tu solución de visor de PDF de ASP.NET Core funcione consistentemente sin importar el entorno de implementación. La biblioteca maneja los detalles específicos de renderizado de plataforma internamente, por lo que el mismo código funciona en todas partes sin modificación.

Cómo Mostrar, Guardar e Imprimir PDFs en un Visor ASP.NET Core: Figura 8 - Compatibilidad Cruzada de Plataforma

El procesamiento del lado del servidor asegura una generación de PDF consistente en todas las plataformas. Ya sea desplegado en servidores Windows o contenedores Linux, el componente mantiene la misma calidad de renderizado. La biblioteca maneja automáticamente las diferencias de rutas entre sistemas operativos, por lo que los archivos en la carpeta wwwroot u otros lugares se gestionan correctamente. Para implementaciones en contenedores, consulta la guía de implementación de Docker. El paquete incluye todas las dependencias necesarias para cada plataforma, y la configuración no requiere ajustes adicionales más allá de los requisitos estándar de ASP.NET Core.

Comienza con una prueba gratuita y transforma tus capacidades de visualización de documentos hoy.

Resumen

IronPDF transforma el manejo de PDF en aplicaciones web de ASP.NET Core combinando la generación del lado del servidor con la visualización nativa del navegador. Con solo unas pocas líneas de código, puedes crear documentos PDF profesionales a partir de HTML, mostrar archivos PDF en línea, habilitar descargas y optimizar para impresión. El motor de renderizado basado en Chrome asegura una precisión perfecta de píxeles en todas las plataformas, eliminando la necesidad de Adobe Acrobat Reader u otros visores de terceros.

Esta solución de visor de PDF de ASP.NET Core proporciona características completas incluyendo relleno de formularios, selección de texto, firmas digitales y la capacidad de editar archivos PDF. El componente también admite convertir documentos de Word (archivos DOCX), hojas de cálculo de Excel e imágenes a PDF. Ya sea que estés construyendo un visor de documentos simple o un sistema de gestión de documentos complejo, IronPDF proporciona las herramientas y soporte que necesitas.

La integración de ayudantes de etiquetas de la biblioteca y su extensa documentación hacen que la implementación sea directa. La página principal de tu proyecto puede mostrar archivos PDF directamente, mientras que el procesamiento de back-end maneja tareas complejas de generación de PDF. El visor mantiene un comportamiento consistente ya sea cargado desde la carpeta wwwroot, generado dinámicamente o recuperado de fuentes externas. Con soporte de temas incorporado y configuraciones de ancho personalizables, puedes ajustar perfectamente el diseño de tu aplicación.

¿Listo para implementar la visualización de PDF en tu Aplicación Web .NET Core?

Para uso en producción, las licencias comienzan en $749 e incluyen soporte completo y actualizaciones. Visita la documentación para referencias detalladas de la API y características avanzadas. Consulta nuestros ejemplos extensos de código para implementar rápidamente la funcionalidad de PDF en tus proyectos de ASP.NET Core.

Cómo Mostrar, Guardar e Imprimir PDFs en un Visor ASP.NET Core: Figura 9 - Licencias

Preguntas Frecuentes

¿Cómo puedo mostrar PDFs en una aplicación ASP.NET Core?

Puedes mostrar PDFs en una aplicación ASP.NET Core usando IronPDF, que proporciona funcionalidades para renderizar archivos PDF directamente dentro de tu aplicación.

¿Cuáles son los pasos para guardar un PDF en ASP.NET Core usando IronPDF?

Para guardar un PDF en ASP.NET Core, puedes usar los métodos integrados de IronPDF para convertir tu documento a formato PDF y luego escribirlo en un sistema de archivos o un flujo.

¿Es posible imprimir PDFs en aplicaciones ASP.NET Core?

Sí, IronPDF te permite imprimir PDFs directamente desde tu aplicación ASP.NET Core usando sus funcionalidades de renderizado e impresión.

¿Cuáles son las ventajas de usar IronPDF en ASP.NET Core?

IronPDF ofrece una integración sin fisuras con ASP.NET Core, permitiendo una fácil manipulación de PDFs como visualización, guardado e impresión, con una configuración mínima.

¿Puede IronPDF manejar documentos PDF grandes en ASP.NET Core?

Sí, IronPDF está optimizado para manejar documentos PDF grandes de manera eficiente, asegurando un rendimiento fluido incluso con archivos complejos.

¿IronPDF soporta anotaciones y comentarios en PDFs en ASP.NET Core?

IronPDF soporta agregar y leer anotaciones y comentarios en PDFs, mejorando la interactividad y usabilidad de los documentos PDF en tu aplicación ASP.NET Core.

¿Cómo integro IronPDF en un proyecto ASP.NET Core existente?

Puedes integrar IronPDF en tu proyecto ASP.NET Core instalando el paquete NuGet de IronPDF y usando su API para gestionar PDFs.

¿Hay requisitos específicos del sistema para usar IronPDF con ASP.NET Core?

IronPDF requiere .NET Core o .NET 5+ y soporta todos los sistemas operativos principales, lo que lo convierte en una opción flexible para proyectos ASP.NET Core.

¿Puede IronPDF convertir otros formatos de archivo a PDF en ASP.NET Core?

Sí, IronPDF puede convertir varios formatos de archivo como HTML, imágenes y documentos a PDF dentro de un entorno ASP.NET Core.

¿Qué tipo de soporte ofrece IronPDF para desarrolladores de ASP.NET Core?

IronPDF proporciona documentación completa, ejemplos de código y soporte receptivo para ayudar a los desarrolladores de ASP.NET Core a implementar funcionalidades de PDF.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
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

Artículos Relacionados

Prueba de 30 días → Producto completo. Sin límites. Sin tarjeta. Comenzar prueba gratuita