Comment ouvrir un PDF dans une nouvelle fenêtre ASP .NET C# avec IronPDF for .NET

Introduction

L'ouverture de fichiers PDF dans une nouvelle fenêtre ou un nouvel onglet du navigateur est une demande courante dans les applications web ASP.NET. Les développeurs sont souvent confrontés à des documents PDF qui se téléchargent automatiquement au lieu de s'afficher dans le navigateur lorsque les utilisateurs cliquent sur un lien. Ce comportement frustrant perturbe l'expérience de l'utilisateur, en particulier lorsqu'il consulte des rapports, des factures ou de la documentation à laquelle il doit se référer tout en continuant à travailler sur la page en cours.

IronPDF apporte une solution élégante à ce défi, en offrant de puissantes fonctionnalités de génération et d'affichage de PDF qui s'intègrent de manière transparente aux applications ASP.NET. Plutôt que de se débattre avec les en-têtes Response et les paramètres Content-Disposition, les développeurs peuvent s'appuyer sur le ChromePdfRenderer d'IronPDF pour créer et servir des fichiers PDF qui s'ouvrent de manière fiable dans de nouveaux onglets du navigateur.

Dans cet article, nous allons voir comment IronPDF est la réponse à la génération et à l'affichage de fichiers PDF dans le navigateur de votre ordinateur.

Pourquoi les fichiers PDF se téléchargent-ils au lieu de s'ouvrir ?

Lors de la diffusion de fichiers PDF via ASP.NET, le comportement par défaut se traduit souvent par des téléchargements plutôt que par l'affichage dans le navigateur. Cela est dû à la manière dont le serveur envoie le fichier au navigateur par le biais des en-têtes de réponse HTTP. L'en-tête Content-Disposition détermine en particulier si un fichier PDF s'ouvre en ligne ou se télécharge.

Le code ASP.NET traditionnel utilisant Response.BinaryWrite avec un tableau d'octets définit souvent des en-têtes qui déclenchent des téléchargements. Même lorsque les développeurs définissent Response.ContentType = "application/pdf", les valeurs Content-Disposition manquantes ou incorrectes font que le navigateur télécharge le document PDF au lieu de l'afficher. En outre, les différents navigateurs traitent les fichiers PDF de manière incohérente - alors que les plugins Adobe PDF Reader peuvent afficher les fichiers en ligne, les navigateurs mobiles procèdent souvent par défaut au téléchargement.

La configuration côté serveur devient encore plus complexe lorsqu'il s'agit de documents PDF générés dynamiquement à partir de chaînes HTML ou de sources de données. Sans le chemin d'accès correct et les en-têtes adéquats, il est difficile d'obtenir un affichage cohérent entre les navigateurs. De nombreux développeurs se tournent vers Stack Overflow discussions à la recherche de solutions à ce problème persistant. Utilisez la fonction de recherche pour trouver des réponses rapides.

Comment IronPDF simplifie-t-il l'affichage des PDF?

IronPDF transforme la tâche complexe de la génération et de l'affichage de PDF en un code simple. Grâce à son moteur de rendu basé sur Chrome, IronPDF génère des documents PDF parfaits au pixel près à partir de contenu HTML, tout en gérant automatiquement les détails techniques qui font souvent trébucher les développeurs.

La classe ChromePdfRenderer de la bibliothèque fournit une approche moderne de la création de PDF. Au lieu de gérer manuellement des tableaux d'octets et des flux de réponses, les développeurs peuvent générer des PDF à partir de chaînes HTML, fichiers HTML, ou d'URL avec de simples appels de méthode. IronPDF gère le processus de rendu en interne, ce qui garantit une sortie cohérente dans différents environnements.

Au-delà de la génération de base, IronPDF offre des options de rendu étendues pour personnaliser la sortie, notamment la taille du papier, les marges et les délais d'exécution JavaScript. Cette flexibilité en fait un outil idéal pour la création de documents simples ou de rapports complexes avec des graphiques et du contenu dynamique. Nous vous invitons à nous faire part de vos commentaires sur les paramètres de rendu que vous préférez.

Comment générer et ouvrir des fichiers PDF avec IronPDF?

Commencez par installer IronPDF via le gestionnaire de paquets NuGet :

Install-Package IronPdf

Voici un exemple complet pour ASP.NET Core qui génère un fichier PDF et le sert pour qu'il s'ouvre dans l'onglet de notre navigateur :

using IronPdf;
using Microsoft.AspNetCore.Mvc;
public class PdfController : Controller
{
    [HttpGet]
    public IActionResult GeneratePdf()
    {
        // Create a new ChromePdfRenderer instance
        var renderer = new ChromePdfRenderer();
        // Generate PDF from HTML string with support for CSS and JavaScript
        string htmlString = @"
            <html>
                <body>
                    <h1>Sample PDF Document</h1>
                    <p>This PDF will open in a new browser tab.</p>
                    <p>Generated on: " + DateTime.Now.ToString() + @"</p>
                </body>
            </html>";
        // Create PDF document with proper format
        var PDF = renderer.RenderHtmlAsPdf(htmlString);
        // Convert to byte array for streaming
        byte[] pdfBytes = pdf.BinaryData;
        // Return file with inline display - key for opening in browser
        Response.Headers.Add("Content-Disposition", "inline; filename=document.pdf");
        Response.Headers.Add("Content-Length", pdfBytes.Length.ToString());
        return File(pdfBytes, "application/pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;
public class PdfController : Controller
{
    [HttpGet]
    public IActionResult GeneratePdf()
    {
        // Create a new ChromePdfRenderer instance
        var renderer = new ChromePdfRenderer();
        // Generate PDF from HTML string with support for CSS and JavaScript
        string htmlString = @"
            <html>
                <body>
                    <h1>Sample PDF Document</h1>
                    <p>This PDF will open in a new browser tab.</p>
                    <p>Generated on: " + DateTime.Now.ToString() + @"</p>
                </body>
            </html>";
        // Create PDF document with proper format
        var PDF = renderer.RenderHtmlAsPdf(htmlString);
        // Convert to byte array for streaming
        byte[] pdfBytes = pdf.BinaryData;
        // Return file with inline display - key for opening in browser
        Response.Headers.Add("Content-Disposition", "inline; filename=document.pdf");
        Response.Headers.Add("Content-Length", pdfBytes.Length.ToString());
        return File(pdfBytes, "application/pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

protected void OpenPdf_Click(object sender, EventArgs e)
{
    var renderer = new ChromePdfRenderer();
    // Generate PDF document from HTML
    var PDF = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>");
    // Get byte array from PDF
    byte[] data = pdf.BinaryData;
    // Clear response and write PDF to browser
    Response.Clear();
    Response.ContentType = "application/pdf";
    Response.AddHeader("Content-Length", data.Length.ToString());
    Response.AddHeader("Content-Disposition", "inline; filename=invoice.pdf");
    Response.BinaryWrite(data);
    Response.End();
}

protected void OpenPdf_Click(object sender, EventArgs e)
{
    var renderer = new ChromePdfRenderer();
    // Generate PDF document from HTML
    var PDF = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>");
    // Get byte array from PDF
    byte[] data = pdf.BinaryData;
    // Clear response and write PDF to browser
    Response.Clear();
    Response.ContentType = "application/pdf";
    Response.AddHeader("Content-Length", data.Length.ToString());
    Response.AddHeader("Content-Disposition", "inline; filename=invoice.pdf");
    Response.BinaryWrite(data);
    Response.End();
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Qu'en est-il du contrôle des onglets du navigateur ?

Alors que le code côté serveur détermine si un PDF s'affiche en ligne, le contrôle de son ouverture dans le même onglet ou dans un nouvel onglet nécessite du JavaScript côté client. L'attribut target dans les liens HTML offre la solution la plus simple pour ouvrir le PDF dans une nouvelle fenêtre :

<a href="/Pdf/GeneratePdf" target="_blank">View File</a>

<a href="/Pdf/GeneratePdf" target="_blank">View File</a>

function openPdfInNewTab() {
    // Open PDF in new window using JavaScript
    window.open('/Pdf/GeneratePdf', '_blank');
    return false; // Prevent default form submission
}

function openPdfInNewTab() {
    // Open PDF in new window using JavaScript
    window.open('/Pdf/GeneratePdf', '_blank');
    return false; // Prevent default form submission
}

<asp:Button ID="btnViewPdf" runat="server"
            OnClientClick="window.open('/Pdf/GeneratePdf', '_blank'); return false;"
            Text="Open PDF in New Tab" />

<asp:Button ID="btnViewPdf" runat="server"
            OnClientClick="window.open('/Pdf/GeneratePdf', '_blank'); return false;"
            Text="Open PDF in New Tab" />

IRON VB CONVERTER ERROR developers@ironsoftware.com

<object data="/Pdf/GeneratePdf" type="application/pdf" width="100%" height="600px">
    <embed src="/Pdf/GeneratePdf" type="application/pdf" />
    <p>Your browser doesn't support embedded PDF documents.
       <a href="/Pdf/GeneratePdf" target="_blank">View PDF File</a>
    </p>
</object>

<object data="/Pdf/GeneratePdf" type="application/pdf" width="100%" height="600px">
    <embed src="/Pdf/GeneratePdf" type="application/pdf" />
    <p>Your browser doesn't support embedded PDF documents.
       <a href="/Pdf/GeneratePdf" target="_blank">View PDF File</a>
    </p>
</object>

Comment gérer différentes sources de fichiers ?

IronPDF excelle dans la gestion de diverses sources d'entrée au-delà des chaînes HTML. Lorsque l'on travaille avec des fichiers PDF existants ou que l'on génère des documents à partir de différents formats de données, la bibliothèque offre des options flexibles pour servir les documents PDF aux utilisateurs.

Pour le chargement de documents PDF existants à partir du bon chemin :

public IActionResult ViewFile(string fileName)
{
    // Ensure correct path to PDF file
    string path = Path.Combine(_webHostEnvironment.WebRootPath, "pdfs", fileName);
    // Load existing PDF document
    var PDF = PdfDocument.FromFile(path);
    // Optionally add additional information to the PDF
    pdf.AddPage(renderer.RenderHtmlAsPdf("<h2>Additional Information</h2>"));
    // Convert to stream for browser display
    var stream = pdf.Stream;
    byte[] bytes = stream.ToArray();
    // Set headers for inline display in new browser tab
    Response.Headers.Add("Content-Disposition", "inline; filename=" + fileName);
    Response.Headers.Add("Content-Length", bytes.Length.ToString());
    return File(bytes, "application/pdf");
}

public IActionResult ViewFile(string fileName)
{
    // Ensure correct path to PDF file
    string path = Path.Combine(_webHostEnvironment.WebRootPath, "pdfs", fileName);
    // Load existing PDF document
    var PDF = PdfDocument.FromFile(path);
    // Optionally add additional information to the PDF
    pdf.AddPage(renderer.RenderHtmlAsPdf("<h2>Additional Information</h2>"));
    // Convert to stream for browser display
    var stream = pdf.Stream;
    byte[] bytes = stream.ToArray();
    // Set headers for inline display in new browser tab
    Response.Headers.Add("Content-Disposition", "inline; filename=" + fileName);
    Response.Headers.Add("Content-Length", bytes.Length.ToString());
    return File(bytes, "application/pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

public IActionResult DisplayFromDatabase(int documentId)
{
    // Retrieve byte array from database or system
    byte[] pdfData = GetPdfFromDatabase(documentId);
    // Load PDF document from bytes
    var PDF = PdfDocument.FromBytes(pdfData);
    // Optionally sign or modify the PDF
    // pdf.SignWithDigitalCertificate(...);
    // Set response headers for inline display
    Response.Headers.Add("Content-Disposition",
                        $"inline; filename=document_{documentId}.pdf");
    Response.Headers.Add("Content-Length", pdfData.Length.ToString());
    // Return file to open in browser
    return File(pdfData, "application/pdf");
}

public IActionResult DisplayFromDatabase(int documentId)
{
    // Retrieve byte array from database or system
    byte[] pdfData = GetPdfFromDatabase(documentId);
    // Load PDF document from bytes
    var PDF = PdfDocument.FromBytes(pdfData);
    // Optionally sign or modify the PDF
    // pdf.SignWithDigitalCertificate(...);
    // Set response headers for inline display
    Response.Headers.Add("Content-Disposition",
                        $"inline; filename=document_{documentId}.pdf");
    Response.Headers.Add("Content-Length", pdfData.Length.ToString());
    // Return file to open in browser
    return File(pdfData, "application/pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Conclusion

Apprendre à ouvrir un PDF dans une nouvelle fenêtre ASP .NET C# devient simple avec IronPDF. En gérant les complexités de la génération de PDF et en définissant correctement les en-têtes HTTP, les développeurs peuvent garantir un affichage cohérent sur tous les navigateurs tout en conservant un code propre et facile à maintenir dans leurs programmes. Que vous travailliez avec des chaînes HTML, des documents PDF existants ou des tableaux d'octets provenant de bases de données, IronPDF fournit les outils nécessaires pour fournir du contenu PDF exactement comme les utilisateurs l'attendent.

Démarrez votre essai gratuit d'IronPDF dès aujourd'hui pour mettre en œuvre une fonctionnalité PDF professionnelle dans vos applications ASP.NET. Pour un déploiement en production, découvrez nos options de licence qui comprennent une assistance complète et des fonctionnalités supplémentaires pour les applications web d'entreprise.