Ícono de mensaje
Saltar al pie de página
  1. IronPDF
  2. Blog de IronPDF
  3. Uso de IronPDF
  4. Visor de PDF para ASP.NET Core
USANDO IRONPDF

Cómo mostrar, guardar e imprimir PDF de forma eficaz en el visor de PDF de ASP.NET Core con IronPDF

Curtis Chau
Curtis Chau
Publicado:

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 muestra cómo IronPDF simplifica la visualización, el guardado y la impresión de archivos PDF en el visor de PDF de ASP.NET Core a través de su potente motor de renderizado basado en Chrome.

Cómo mostrar, guardar e imprimir PDFs de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 1 - IronPDF

¿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 mediante 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.

Cómo mostrar, guardar e imprimir PDF de forma eficaz en el visor de PDF de ASP.NET Core con IronPDF: Imagen 2 - Características

¿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

Instale IronPDF a través de NuGet Package Manager en su proyecto .NET:

Install-Package IronPdf
Install-Package IronPdf
SHELL

Cómo mostrar, guardar e imprimir PDFs de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 3 - Instalación

O en el Explorador de soluciones, haga clic con el botón derecho del ratón en el proyecto y seleccione "Administrar paquetes NuGet". Elija la fuente de paquetes adecuada y busque 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, guardar e imprimir PDFs de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 4 - ASP.NET Core PDF Viewer - IronPDF

¿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 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 de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 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. Más información sobre Opciones de conversión de HTML a PDF en la documentación. Para funciones avanzadas de procesamiento y edición, consulte 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

Al añadir el parámetro de nombre de archivo, el encabezado Content-Disposition se establece automáticamente como "adjunto", lo que hace que el navegador descargue el archivo. Los usuarios también pueden guardar los archivos PDF mostrados en línea mediante la función de guardado integrada en el 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 de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 6 - Browser PDF Output

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 puede cargar archivos PDF existentes desde la carpeta wwwroot u otras ubicaciones, editarlos y transmitir las versiones modificadas. Para obtener información más avanzada sobre la manipulación de documentos PDF y el procesamiento de imágenes, consulte PdfDocument API reference. 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

Si se establece CssMediaType en Imprimir, se aplican estilos CSS específicos para impresión, lo que garantiza que el documento PDF tenga un aspecto 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. Más información sobre Opciones de generación de PDF para ajustar el resultado. El componente de visualización de PDF maneja automáticamente todos los detalles de la impresión.

Resultado

Cómo mostrar, guardar e imprimir PDFs de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 7 - Imprimir 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 entre plataformas garantiza que su solución de visor de PDF ASP.NET Core funcione de forma coherente independientemente del 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 de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 8 - Compatibilidad entre plataformas

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 gestiona automáticamente las diferencias de ruta entre sistemas operativos, por lo que los archivos de la carpeta wwwroot u otras ubicaciones 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.

Comience con una prueba gratuita y transforme hoy mismo las capacidades de su visor de documentos.

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 coherente tanto si se carga desde la carpeta wwwroot, se genera dinámicamente o se recupera 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 cuestan a partir de 749 $ e incluyen soporte y actualizaciones completas. Visita la documentación para referencias detalladas de la API y características avanzadas. Consulte nuestros amplios ejemplos de código para implementar rápidamente la funcionalidad PDF en sus proyectos ASP.NET Core.

Cómo mostrar, guardar e imprimir PDFs de forma efectiva en ASP.NET Core PDF Viewer usando IronPDF: Imagen 9 - Licencias

Preguntas Frecuentes

¿Cómo puede IronPDF ayudar a mostrar archivos PDF en aplicaciones ASP.NET Core?

IronPDF simplifica el proceso utilizando un potente motor de renderizado basado en Chrome para mostrar archivos PDF directamente en navegadores web sin necesidad de descargas ni plugins adicionales.

¿Cuáles son las ventajas de utilizar un visor de PDF en ASP.NET Core?

El uso de un visor de PDF como IronPDF en ASP.NET Core mejora la experiencia del usuario, ya que permite ver, guardar e imprimir PDF sin problemas dentro del navegador, eliminando la necesidad de aplicaciones externas como Adobe Acrobat Reader.

¿Es necesario instalar Adobe Acrobat Reader para ver archivos PDF con IronPDF?

No, IronPDF permite ver archivos PDF directamente en el navegador, eliminando la necesidad de Adobe Acrobat Reader o cualquier otro plugin.

¿Qué tipos de documentos pueden mostrarse con IronPDF en una aplicación ASP.NET Core?

IronPDF puede utilizarse para mostrar sin problemas diversos tipos de documentos, como facturas, informes y contratos, en aplicaciones ASP.NET Core.

¿Es IronPDF compatible con la impresión de documentos PDF en ASP.NET Core?

Sí, IronPDF admite la impresión de documentos PDF directamente desde la aplicación web, proporcionando una solución completa de gestión de PDF.

¿Puede IronPDF renderizar diseños PDF complejos con precisión en ASP.NET Core?

IronPDF utiliza un motor de renderizado basado en Chrome para renderizar con precisión diseños PDF complejos, garantizando una visualización de alta calidad sin pérdida de fidelidad.

¿Necesito descargar archivos PDF para verlos con IronPDF en ASP.NET Core?

No, IronPDF permite a los usuarios ver archivos PDF directamente en el navegador web sin necesidad de descargarlos.

¿Cómo mejora IronPDF la experiencia de visualización de PDF en aplicaciones web?

IronPDF mejora la experiencia de visualización de PDF al ofrecer una integración perfecta con ASP.NET Core, lo que permite a los usuarios ver, guardar e imprimir PDF directamente en el navegador.

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