Jak otworzyć PDF w nowych oknach przy użyciu ASP.NET C# i IronPDF

Dlaczego warto zwracać uwagę na problemy z wyświetlaniem plików PDF?

Podczas udostępniania plików PDF za pośrednictwem ASP.NET domyślne zachowanie często powoduje pobranie pliku zamiast wyświetlenia go w przeglądarce. Dzieje się tak ze względu na sposób, w jaki serwer wysyła plik do przeglądarki za pośrednictwem nagłówków odpowiedzi HTTP. Nagłówek Content-Disposition określa, czy plik PDF otwiera się w oknie przeglądarki, czy jest pobierany.

Tradycyjny kod ASP.NET wykorzystujący Response.BinaryWrite z tablicą bajtów często ustawia nagłówki, które uruchamiają pobieranie plików. Nawet jeśli programiści ustawią Response.ContentType = "application/pdf", brakujące lub nieprawidłowe wartości Content-Disposition powodują, że przeglądarka pobiera dokument PDF zamiast go wyświetlać. Różne przeglądarki obsługują pliki PDF w różny sposób — podczas gdy niektóre przeglądarki stacjonarne mogą domyślnie wyświetlać pliki w trybie inline, przeglądarki mobilne często domyślnie pobierają je.

Kiedy te problemy występują najczęściej?

Konfiguracja po stronie serwera staje się bardziej złożona podczas pracy z dokumentami PDF generowanymi dynamicznie na podstawie ciągów znaków HTML lub źródeł z baz danych. Bez prawidłowej ścieżki i odpowiednich nagłówków osiągnięcie spójnego wyświetlania w różnych przeglądarkach stanowi prawdziwe wyzwanie. Wielu programistów zwraca się do serwisu Stack Overflow w poszukiwaniu rozwiązań tego uporczywego problemu. Wpis w MDN Web Docs dotyczący Content-Disposition stanowi autorytatywne źródło informacji pozwalające zrozumieć dokładną składnię i zachowanie przeglądarek zarówno w przypadku wartości inline, jak i attachment.

Czym wyróżnia się podejście IronPDF?

Klasa ChromePdfRenderer biblioteki zapewnia nowoczesne podejście do tworzenia plików PDF. Zamiast ręcznie zarządzać tablicami bajtów i strumieniami odpowiedzi, programiści mogą generować pliki PDF z ciągów znaków HTML, plików HTML lub adresów URL za pomocą prostych wywołań metod. IronPDF obsługuje proces renderowania wewnętrznie, zapewniając spójny wynik w różnych środowiskach.

Które funkcje są najbardziej pomocne?

Oprócz podstawowego generowania, IronPDF oferuje szerokie możliwości renderowania w celu dostosowania wyników, w tym rozmiar papieru, marginesy i opóźnienia w wykonywaniu kodu JavaScript. Ta elastyczność sprawia, że nadaje się on do tworzenia wszystkiego, od prostych dokumentów po złożone raporty z wykresami i treścią dynamiczną.

Silnik renderujący obsługuje również niestandardowe nagłówki i stopki, znaki wodne oraz numerację stron — wszystko to konfiguruje się za pomocą prostego obiektu opcji przed wywołaniem metody renderowania. Dla programistów, którzy muszą dostosować się do istniejącego przewodnika stylistycznego marki, ten poziom kontroli nad formatem wyjściowym stanowi znaczną przewagę w porównaniu z ręcznym tworzeniem danych binarnych PDF.

Jak wygląda wygenerowany plik PDF?

Powyższy kod wykorzystuje [HttpGet]. Podczas tworzenia pliku PDF po przesłaniu formularza przez użytkownika należy zamiast tego użyć atrybutu [HttpPost]. To rozróżnienie ma znaczenie: żądania GET powinny być idempotentne, podczas gdy żądania POST przenoszą przesłane dane formularza używane do wygenerowania spersonalizowanego dokumentu.

Zwróć uwagę, że użyto Response.Headers.Append zamiast Response.Headers.Add. W .NET Core metoda Append jest preferowanym interfejsem API do dodawania nagłówków odpowiedzi, ponieważ nie generuje wyjątku, jeśli nagłówek już istnieje. Użycie Add może powodować wyjątki w potokach oprogramowania pośredniczącego, w których nagłówki mogły zostać już częściowo ustawione.

Dlaczego nagłówek Content-Disposition ma znaczenie?

Kluczowym szczegółem umożliwiającym otwieranie plików PDF w przeglądarce jest ustawienie nagłówka Content-Disposition na "inline" zamiast "attachment". Wartość "attachment" nakazuje przeglądarce pobranie pliku i zapisanie go na dysku. Ustawienie "inline" nakazuje przeglądarce próbę wyświetlenia pliku w oknie przeglądarki — co nowoczesne przeglądarki obsługujące natywne renderowanie PDF robią automatycznie.

Jak to zaimplementować w WebForms?

W przypadku aplikacji WebForms można dostarczyć plik PDF bezpośrednio poprzez odpowiedź HTTP i wywołać wyświetlenie w przeglądarce po kliknięciu przycisku:

using IronPdf;

protected void OpenPdf_Click(object sender, EventArgs e)
{
    var renderer = new ChromePdfRenderer();

    // Generate PDF from HTML content
    var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>");

    // Get byte array from the PDF document
    byte[] data = pdf.BinaryData;

    // Clear any existing response output
    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();
}

using IronPdf;

protected void OpenPdf_Click(object sender, EventArgs e)
{
    var renderer = new ChromePdfRenderer();

    // Generate PDF from HTML content
    var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>");

    // Get byte array from the PDF document
    byte[] data = pdf.BinaryData;

    // Clear any existing response output
    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();
}

Imports IronPdf

Protected Sub OpenPdf_Click(sender As Object, e As EventArgs)
    Dim renderer As New ChromePdfRenderer()

    ' Generate PDF from HTML content
    Dim pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Your order details</p>")

    ' Get byte array from the PDF document
    Dim data As Byte() = pdf.BinaryData

    ' Clear any existing response output
    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()
End Sub

Jeśli potrzebujesz również tworzyć formularze PDF lub dodawać podpisy cyfrowe, IronPDF zapewnia wbudowaną obsługę obu tych zaawansowanych funkcji.

Jak wyświetla się plik PDF w nowej karcie?

Kiedy warto używać JavaScript, aby uzyskać większą kontrolę?

W sytuacjach, gdy adres URL jest ustalany dynamicznie, funkcja JavaScript window.open zapewnia precyzyjną kontrolę nad tym, kiedy i w jaki sposób otwiera się zakładka PDF:

function openPdfInNewTab() {
    // Open the PDF endpoint in a new browser tab
    window.open('/Pdf/GeneratePdf', '_blank');
    return false; // Prevent default link or form submission behavior
}

function openPdfInNewTab() {
    // Open the PDF endpoint in a new browser tab
    window.open('/Pdf/GeneratePdf', '_blank');
    return false; // Prevent default link or form submission behavior
}

Jak połączyć JavaScript z kontrolkami ASP.NET?

W aplikacjach ASP.NET WebForms należy dołączyć wywołanie JavaScript bezpośrednio do kontrolki przycisku za pomocą atrybutu OnClientClick:

<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" />

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

W przypadku użycia window.open(), drugi argument '_blank' jest parametrem docelowym, który otwiera dokument w nowym, oddzielnym oknie lub zakładce. Odzwierciedla to zachowanie target="_blank" w standardowym tagu kotwicy HTML.

A co z osadzaniem plików PDF bezpośrednio na stronie?

Tag HTML <object> stanowi kolejną opcję osadzania dokumentów PDF bezpośrednio na bieżącej stronie, co jest przydatne, gdy użytkownicy muszą czytać dokument równolegle z innymi treściami:

<object data="/Pdf/GeneratePdf" type="application/pdf" width="100%" height="600px">
    <embed src="/Pdf/GeneratePdf" type="application/pdf" />
    <p>Your browser does not support embedded PDF documents.
       <a href="/Pdf/GeneratePdf" target="_blank">View the 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 does not support embedded PDF documents.
       <a href="/Pdf/GeneratePdf" target="_blank">View the PDF file</a>
    </p>
</object>

Jak wygląda osadzony plik PDF?

To podejście sprawdza się dobrze w nowoczesnych przeglądarkach obsługujących natywne renderowanie plików PDF. Zgodnie z dokumentacją Microsoftu dotyczącą .NET Core, odpowiednie nagłówki HTTP w połączeniu z kodem po stronie klienta zapewniają najbardziej niezawodne rozwiązanie działające w różnych przeglądarkach. Należy pamiętać, że atrybut target="_blank" jest niezbędny w linku rezerwowym.

Jak wczytać istniejące pliki PDF?

W celu wczytania istniejących dokumentów PDF z dysku i wyświetlenia ich wbudowanych:

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    private readonly IWebHostEnvironment _env;

    public PdfController(IWebHostEnvironment env) => _env = env;

    [HttpGet("ViewFile")]
    public IActionResult ViewFile(string fileName)
    {
        // Build the full path to the PDF on disk
        string path = Path.Combine(_env.WebRootPath, "pdfs", fileName);

        // Load the existing PDF document
        var pdf = PdfDocument.FromFile(path);

        // Read the binary content from the PDF stream
        byte[] bytes = pdf.Stream.ToArray();

        // Serve inline so the browser displays it directly
        Response.Headers.Append("Content-Disposition", $"inline; filename={fileName}");
        Response.Headers.Append("Content-Length", bytes.Length.ToString());

        return File(bytes, "application/pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    private readonly IWebHostEnvironment _env;

    public PdfController(IWebHostEnvironment env) => _env = env;

    [HttpGet("ViewFile")]
    public IActionResult ViewFile(string fileName)
    {
        // Build the full path to the PDF on disk
        string path = Path.Combine(_env.WebRootPath, "pdfs", fileName);

        // Load the existing PDF document
        var pdf = PdfDocument.FromFile(path);

        // Read the binary content from the PDF stream
        byte[] bytes = pdf.Stream.ToArray();

        // Serve inline so the browser displays it directly
        Response.Headers.Append("Content-Disposition", $"inline; filename={fileName}");
        Response.Headers.Append("Content-Length", bytes.Length.ToString());

        return File(bytes, "application/pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<Route("[controller]")>
Public Class PdfController
    Inherits Controller

    Private ReadOnly _env As IWebHostEnvironment

    Public Sub New(env As IWebHostEnvironment)
        _env = env
    End Sub

    <HttpGet("ViewFile")>
    Public Function ViewFile(fileName As String) As IActionResult
        ' Build the full path to the PDF on disk
        Dim path As String = Path.Combine(_env.WebRootPath, "pdfs", fileName)

        ' Load the existing PDF document
        Dim pdf = PdfDocument.FromFile(path)

        ' Read the binary content from the PDF stream
        Dim bytes As Byte() = pdf.Stream.ToArray()

        ' Serve inline so the browser displays it directly
        Response.Headers.Append("Content-Disposition", $"inline; filename={fileName}")
        Response.Headers.Append("Content-Length", bytes.Length.ToString())

        Return File(bytes, "application/pdf")
    End Function
End Class

Jak wygląda otwieranie istniejącego pliku PDF?

Jak pracować z plikami PDF z baz danych?

Praca z tablicami bajtów pobranymi z bazy danych wymaga ostrożnego postępowania, aby poprawnie załadować dokument przed jego udostępnieniem:

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    [HttpGet("DisplayFromDatabase/{documentId:int}")]
    public IActionResult DisplayFromDatabase(int documentId)
    {
        // Retrieve the stored byte array from the database
        byte[] pdfData = GetPdfFromDatabase(documentId);

        // Load into an IronPDF document object for optional manipulation
        var pdf = PdfDocument.FromBytes(pdfData);

        // Set response headers for inline browser display
        Response.Headers.Append(
            "Content-Disposition",
            $"inline; filename=document_{documentId}.pdf");
        Response.Headers.Append("Content-Length", pdfData.Length.ToString());

        return File(pdfData, "application/pdf");
    }

    private static byte[] GetPdfFromDatabase(int documentId)
    {
        // Replace with actual database retrieval logic
        return Array.Empty<byte>();
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[Route("[controller]")]
public class PdfController : Controller
{
    [HttpGet("DisplayFromDatabase/{documentId:int}")]
    public IActionResult DisplayFromDatabase(int documentId)
    {
        // Retrieve the stored byte array from the database
        byte[] pdfData = GetPdfFromDatabase(documentId);

        // Load into an IronPDF document object for optional manipulation
        var pdf = PdfDocument.FromBytes(pdfData);

        // Set response headers for inline browser display
        Response.Headers.Append(
            "Content-Disposition",
            $"inline; filename=document_{documentId}.pdf");
        Response.Headers.Append("Content-Length", pdfData.Length.ToString());

        return File(pdfData, "application/pdf");
    }

    private static byte[] GetPdfFromDatabase(int documentId)
    {
        // Replace with actual database retrieval logic
        return Array.Empty<byte>();
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<Route("[controller]")>
Public Class PdfController
    Inherits Controller

    <HttpGet("DisplayFromDatabase/{documentId:int}")>
    Public Function DisplayFromDatabase(documentId As Integer) As IActionResult
        ' Retrieve the stored byte array from the database
        Dim pdfData As Byte() = GetPdfFromDatabase(documentId)

        ' Load into an IronPDF document object for optional manipulation
        Dim pdf = PdfDocument.FromBytes(pdfData)

        ' Set response headers for inline browser display
        Response.Headers.Append("Content-Disposition", $"inline; filename=document_{documentId}.pdf")
        Response.Headers.Append("Content-Length", pdfData.Length.ToString())

        Return File(pdfData, "application/pdf")
    End Function

    Private Shared Function GetPdfFromDatabase(documentId As Integer) As Byte()
        ' Replace with actual database retrieval logic
        Return Array.Empty(Of Byte)()
    End Function
End Class

Jakie opcje renderowania można dostosować?

IronPDF obsługuje zaawansowaną konwersję HTML do PDF, w tym style CSS, obrazy i czcionki internetowe. Biblioteka zawiera również przewodniki dotyczące rozwiązywania problemów, które pomagają osiągnąć idealne wyniki w środowiskach produkcyjnych.

Poniższa tabela zawiera podsumowanie głównych strategii serwowania oraz wskazówki dotyczące tego, kiedy należy stosować każdą z nich: