Przeglądarka plików PDF ASP.NET MVC: Stwórz bezpieczne rozwiązanie po stronie serwera

Jak stworzyć przeglądarkę plików PDF dla ASP.NET MVC?

Konfiguracja przeglądarki plików PDF opartej na ASP rozpoczyna się od zainstalowania IronPDF za pomocą menedżera pakietów NuGet. Ten kontrolka przeglądarki plików PDF .NET zapewnia możliwości przetwarzania po stronie serwera, które eliminują problemy z kompatybilnością przeglądarek. Szczegółowe instrukcje dotyczące instalacji można znaleźć w dokumentacji instalacyjnej IronPDF oraz w instrukcji konfiguracji dla systemu Windows.

Install-Package IronPdf

Install-Package IronPdf

dotnet add package IronPdf

dotnet add package IronPdf

W kontrolerze ASP.NET MVC dodaj niezbędne przestrzenie nazw:

using IronPdf;
using System.Web.Mvc;

using IronPdf;
using System.Web.Mvc;

Imports IronPdf
Imports System.Web.Mvc

Te importy umożliwiają aplikacji internetowej obsługę renderowania i wyświetlania plików PDF. Klasa ChromePdfRenderer stanowi podstawowy komponent kontrolki przeglądarki plików PDF MVC, udostępniając metody do tworzenia, edycji i wyświetlania plików PDF bezpośrednio w przeglądarkach użytkowników. W przeciwieństwie do rozwiązań po stronie klienta, IronPDF przetwarza wszystko na serwerze przy użyciu silnika renderującego Chrome, zapewniając spójne renderowanie na wszystkich urządzeniach i przeglądarkach, przy jednoczesnym zachowaniu kontroli nad dokumentami PDF. Kluczową zaletą jest wdrożenie zabezpieczeń.

Jak wyświetlać pliki PDF w aplikacji internetowej .NET MVC?

Stworzenie kontrolki przeglądarki PDF, która wyświetla istniejące pliki PDF, wymaga zaimplementowania akcji kontrolera, która zwraca dokument jako FileResult. Takie podejście pozwala użytkownikom przeglądać strony PDF bezpośrednio w przeglądarce bez konieczności ręcznego przesyłania lub wybierania plików. W przypadku zaawansowanych scenariuszy zapoznaj się z opcjami renderowania i konfiguracją okna podglądu w IronPDF.

// Load existing PDF and stream it inline to the browser
var pdfPath = Server.MapPath($"~/Content/PDFs/{fileName}");
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Set response headers to display in browser rather than download
Response.Headers.Add("Content-Disposition", "inline; filename=" + fileName);

return File(pdf.BinaryData, "application/pdf");

// Load existing PDF and stream it inline to the browser
var pdfPath = Server.MapPath($"~/Content/PDFs/{fileName}");
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Set response headers to display in browser rather than download
Response.Headers.Add("Content-Disposition", "inline; filename=" + fileName);

return File(pdf.BinaryData, "application/pdf");

' Load existing PDF and stream it inline to the browser
Dim pdfPath As String = Server.MapPath($"~/Content/PDFs/{fileName}")
Dim pdf As PdfDocument = PdfDocument.FromFile(pdfPath)

' Set response headers to display in browser rather than download
Response.Headers.Add("Content-Disposition", "inline; filename=" & fileName)

Return File(pdf.BinaryData, "application/pdf")

Ten kod ładuje dokument PDF z systemu plików serwera i wysyła go do przeglądarki. Nagłówek Content-Disposition: inline informuje przeglądarkę, aby wyświetlała pliki PDF w oknie przeglądarki zamiast uruchamiać pobieranie. Metoda PdfDocument.FromFile odczytuje istniejący plik, natomiast pdf.BinaryData dostarcza tablicę bajtów potrzebną do strumieniowania. Aby poprawić wydajność przy pracy z dużymi plikami, warto rozważyć zastosowanie technik kompresji plików PDF.

Ta prosta implementacja tworzy funkcjonalną przeglądarkę plików PDF opartą na architekturze MVC, która efektywnie obsługuje pliki o różnych rozmiarach. Aby zapewnić responsywne wyświetlanie, przeglądarka automatycznie dostosowuje wyświetlanie w oparciu o wymiary okna wyświetlania, gwarantując, że przeglądarka plików PDF działa na urządzeniach mobilnych. Zgodnie z dyskusjami na Stack Overflow, to podejście po stronie serwera zapewnia lepszą kontrolę niż osadzanie wtyczek.

Jak przekonwertować widoki na dokumenty PDF?

Przeglądarka plików PDF ASP.NET MVC może dynamicznie generować dokumenty PDF z widoków Razor, umożliwiając tworzenie dokumentów opartych na danych. Ta funkcja pozwala przekształcić dowolny widok w profesjonalnie sformatowane pliki PDF. Dowiedz się więcej o konwersji CSHTML do formatu PDF zarówno w środowisku MVC Framework, jak i MVC Core.

// Sample data for the view
var model = new ReportModel
{
    Title = "Monthly Report",
    Data = ReportModel.GetReportData()
};

// Initialize renderer and configure options
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.EnableJavaScript = true;

// Render MVC Razor view to PDF
var pdf = renderer.RenderView(this.HttpContext,
                              "~/Views/Reports/Monthly.cshtml",
                              model);

// Display inline in browser
Response.Headers.Add("Content-Disposition", "inline");
return File(pdf.BinaryData, "application/pdf");

// Sample data for the view
var model = new ReportModel
{
    Title = "Monthly Report",
    Data = ReportModel.GetReportData()
};

// Initialize renderer and configure options
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.EnableJavaScript = true;

// Render MVC Razor view to PDF
var pdf = renderer.RenderView(this.HttpContext,
                              "~/Views/Reports/Monthly.cshtml",
                              model);

// Display inline in browser
Response.Headers.Add("Content-Disposition", "inline");
return File(pdf.BinaryData, "application/pdf");

Imports System.Web.Mvc

' Sample data for the view
Dim model As New ReportModel With {
    .Title = "Monthly Report",
    .Data = ReportModel.GetReportData()
}

' Initialize renderer and configure options
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.EnableJavaScript = True

' Render MVC Razor view to PDF
Dim pdf = renderer.RenderView(Me.HttpContext,
                              "~/Views/Reports/Monthly.cshtml",
                              model)

' Display inline in browser
Response.Headers.Add("Content-Disposition", "inline")
Return File(pdf.BinaryData, "application/pdf")

Metoda RenderView konwertuje widok CSHTML na dokument PDF, zachowując wszystkie style i układ. RenderingOptions pozwala kontrolować marginesy, włączyć wykonywanie kodu JavaScript oraz skonfigurować inne właściwości wyświetlania. Renderowanie po stronie serwera zapewnia spójny wynik niezależnie od przeglądarki lub urządzenia użytkownika, obsługując kodowanie UTF-8 dla treści międzynarodowych. W przypadku zaawansowanych potrzeb stylistycznych warto zapoznać się z opcjami renderowania, takimi jak kontrola typów mediów CSS i obsługa czcionek internetowych.

Wygenerowane strony PDF zachowują elementy responsywnego projektu widoku, automatycznie dostosowując zawartość w celu optymalnego wyświetlania. W przypadku złożonych układów można dodać nagłówki i stopki, aby stworzyć profesjonalne dokumenty z numerami stron. To lekkie rozwiązanie obsługuje również niestandardowe rozmiary papieru i kontrolę orientacji strony.

// Generate PDF with advanced rendering options
var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
renderer.RenderingOptions.WaitFor.RenderDelay = 500;

// Add a watermark header for draft documents
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "DRAFT - CONFIDENTIAL",
    FontSize = 12,
    FontFamily = "Arial",
    DrawDividerLine = true
};

var html = RenderPartialViewToString("~/Views/Reports/Advanced.cshtml", GetAdvancedModel());
var pdf = renderer.RenderHtmlAsPdf(html);

return File(pdf.BinaryData, "application/pdf");

// Generate PDF with advanced rendering options
var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
renderer.RenderingOptions.WaitFor.RenderDelay = 500;

// Add a watermark header for draft documents
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "DRAFT - CONFIDENTIAL",
    FontSize = 12,
    FontFamily = "Arial",
    DrawDividerLine = true
};

var html = RenderPartialViewToString("~/Views/Reports/Advanced.cshtml", GetAdvancedModel());
var pdf = renderer.RenderHtmlAsPdf(html);

return File(pdf.BinaryData, "application/pdf");

Imports IronPdf

' Generate PDF with advanced rendering options
Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.CreatePdfFormsFromHtml = True
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
renderer.RenderingOptions.WaitFor.RenderDelay = 500

' Add a watermark header for draft documents
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
    .CenterText = "DRAFT - CONFIDENTIAL",
    .FontSize = 12,
    .FontFamily = "Arial",
    .DrawDividerLine = True
}

Dim html As String = RenderPartialViewToString("~/Views/Reports/Advanced.cshtml", GetAdvancedModel())
Dim pdf = renderer.RenderHtmlAsPdf(html)

Return File(pdf.BinaryData, "application/pdf")

Jakie funkcje interaktywne można dodać do przeglądarki plików PDF?

Nowoczesne kontrolki przeglądarki PDF wymagają funkcji interaktywnych wykraczających poza podstawowe wyświetlanie. IronPDF automatycznie włącza funkcje zaznaczania i wyszukiwania tekstu podczas renderowania plików PDF. Użytkownicy mogą zaznaczać i kopiować treści bezpośrednio z wyświetlanych dokumentów. Funkcje te poprawiają komfort użytkowania i zwiększają funkcjonalność przeglądarki plików PDF ASP.NET MVC, obsługując funkcje adnotacji i zarządzania formularzami.

// Load PDF and enable interactive features
var pdf = LoadPdfDocument(documentId);

pdf.SecuritySettings.AllowUserFormData = true;
pdf.Bookmarks.AddBookMarkAtStart("Table of Contents", 1);
pdf.Bookmarks.AddBookMarkAtStart("Chapter 1", 5);

// Configure viewer toolbar to show navigation controls
Response.Headers.Add("Content-Disposition",
                    "inline; filename=document.pdf#toolbar=1");

return File(pdf.BinaryData, "application/pdf");

// Load PDF and enable interactive features
var pdf = LoadPdfDocument(documentId);

pdf.SecuritySettings.AllowUserFormData = true;
pdf.Bookmarks.AddBookMarkAtStart("Table of Contents", 1);
pdf.Bookmarks.AddBookMarkAtStart("Chapter 1", 5);

// Configure viewer toolbar to show navigation controls
Response.Headers.Add("Content-Disposition",
                    "inline; filename=document.pdf#toolbar=1");

return File(pdf.BinaryData, "application/pdf");

' Load PDF and enable interactive features
Dim pdf = LoadPdfDocument(documentId)

pdf.SecuritySettings.AllowUserFormData = True
pdf.Bookmarks.AddBookMarkAtStart("Table of Contents", 1)
pdf.Bookmarks.AddBookMarkAtStart("Chapter 1", 5)

' Configure viewer toolbar to show navigation controls
Response.Headers.Add("Content-Disposition", "inline; filename=document.pdf#toolbar=1")

Return File(pdf.BinaryData, "application/pdf")

To wdrożenie umożliwia wypełnianie formularzy, pozwalając użytkownikom na przesyłanie danych z formularzy PDF bezpośrednio w przeglądarce. Dodane zakładki tworzą strukturę ułatwiającą poruszanie się po długich dokumentach. Wbudowany parametr paska narzędzi w nagłówku Content-Disposition zapewnia użytkownikom dostęp do narzędzi przeglądarki służących do Zoomu, PRINT-u i pobierania.

Funkcje te przekształcają podstawowy wyświetlacz w kompletną przeglądarkę plików PDF ASP.NET MVC, która obsługuje pełną interakcję z dokumentem. W przypadku zaawansowanych scenariuszy warto zapoznać się z funkcjami adnotacji IronPDF, które pozwalają dodawać komentarze i zaznaczenia do stron PDF. Warto rozważyć wdrożenie zgodności z formatem PDF/A na potrzeby długoterminowej archiwizacji.

// Create an interactive PDF with embedded form fields
var renderer = new ChromePdfRenderer();
var html = @"
    <html>
    <body>
        <h1>Interactive PDF Form</h1>
        <form>
            <label>Name: <input type='text' name='fullname'/></label><br/>
            <label>Email: <input type='email' name='email'/></label><br/>
            <label>Comments: <textarea name='comments'></textarea></label><br/>
            <input type='submit' value='Submit'/>
        </form>
    </body>
    </html>";

// Enable HTML form-to-PDF-form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
var pdf = renderer.RenderHtmlAsPdf(html);

// Add an instructional annotation
pdf.AddTextAnnotation("Please fill out all fields", 1, 100, 100, 200, 50);

return File(pdf.BinaryData, "application/pdf");

// Create an interactive PDF with embedded form fields
var renderer = new ChromePdfRenderer();
var html = @"
    <html>
    <body>
        <h1>Interactive PDF Form</h1>
        <form>
            <label>Name: <input type='text' name='fullname'/></label><br/>
            <label>Email: <input type='email' name='email'/></label><br/>
            <label>Comments: <textarea name='comments'></textarea></label><br/>
            <input type='submit' value='Submit'/>
        </form>
    </body>
    </html>";

// Enable HTML form-to-PDF-form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
var pdf = renderer.RenderHtmlAsPdf(html);

// Add an instructional annotation
pdf.AddTextAnnotation("Please fill out all fields", 1, 100, 100, 200, 50);

return File(pdf.BinaryData, "application/pdf");

Imports System.IO

' Create an interactive PDF with embedded form fields
Dim renderer As New ChromePdfRenderer()
Dim html As String = "
    <html>
    <body>
        <h1>Interactive PDF Form</h1>
        <form>
            <label>Name: <input type='text' name='fullname'/></label><br/>
            <label>Email: <input type='email' name='email'/></label><br/>
            <label>Comments: <textarea name='comments'></textarea></label><br/>
            <input type='submit' value='Submit'/>
        </form>
    </body>
    </html>"

' Enable HTML form-to-PDF-form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = True
Dim pdf = renderer.RenderHtmlAsPdf(html)

' Add an instructional annotation
pdf.AddTextAnnotation("Please fill out all fields", 1, 100, 100, 200, 50)

Return File(pdf.BinaryData, "application/pdf")

Jak zabezpieczyć kontrolkę przeglądarki plików PDF?

Bezpieczeństwo ma kluczowe znaczenie podczas wdrażania przeglądarki plików PDF w aplikacji internetowej. IronPDF zapewnia wielowarstwową ochronę poufnych dokumentów PDF dzięki kompleksowym funkcjom bezpieczeństwa. Zgodnie z najlepszymi praktykami Microsoftu w zakresie bezpieczeństwa przetwarzanie po stronie serwera zapewnia lepszą kontrolę niż biblioteki po stronie klienta.

// Apply security settings to restrict PDF access
var pdf = GenerateConfidentialPdf();

pdf.SecuritySettings.UserPassword = "MySecretPassword";
pdf.SecuritySettings.OwnerPassword = "OwnerSecretPassword";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit;

// Prevent unauthorized embedding in external sites
Response.Headers.Add("X-Frame-Options", "SAMEORIGIN");
Response.Headers.Add("Content-Security-Policy",
                    "frame-ancestors 'self'");

return File(pdf.BinaryData, "application/pdf");

// Apply security settings to restrict PDF access
var pdf = GenerateConfidentialPdf();

pdf.SecuritySettings.UserPassword = "MySecretPassword";
pdf.SecuritySettings.OwnerPassword = "OwnerSecretPassword";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit;

// Prevent unauthorized embedding in external sites
Response.Headers.Add("X-Frame-Options", "SAMEORIGIN");
Response.Headers.Add("Content-Security-Policy",
                    "frame-ancestors 'self'");

return File(pdf.BinaryData, "application/pdf");

' Apply security settings to restrict PDF access
Dim pdf = GenerateConfidentialPdf()

pdf.SecuritySettings.UserPassword = "MySecretPassword"
pdf.SecuritySettings.OwnerPassword = "OwnerSecretPassword"
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit

' Prevent unauthorized embedding in external sites
Response.Headers.Add("X-Frame-Options", "SAMEORIGIN")
Response.Headers.Add("Content-Security-Policy", "frame-ancestors 'self'")

Return File(pdf.BinaryData, "application/pdf")

Te środki bezpieczeństwa chronią pliki PDF przed nieautoryzowanym dostępem i rozpowszechnianiem. Ochrona hasłem wymaga uwierzytelnienia przed wyświetleniem, a ustawienia uprawnień uniemożliwiają kopiowanie lub drukowanie poufnych treści. Nagłówki zabezpieczeń uniemożliwiają osadzanie kontrolki przeglądarki plików PDF w nieautoryzowanych witrynach zewnętrznych. Aby zapewnić dodatkową ochronę, rozważ zredagowanie wrażliwego tekstu w celu trwałego usunięcia informacji poufnych.

Aby zapoznać się z dodatkowymi opcjami zabezpieczeń, przejrzyj przykłady zabezpieczeń IronPDF.

Jak wypadają różne przeglądarki plików PDF w porównaniu?

Wybór odpowiedniej strategii wyświetlania plików PDF zależy od wymagań bezpieczeństwa aplikacji, obsługiwanych przeglądarek oraz ograniczeń infrastruktury. Poniższa tabela podsumowuje trzy główne podejścia dostępne podczas tworzenia przeglądarki plików PDF dla .NET MVC.

Każde z tych rozwiązań przetwarza dokumenty całkowicie po stronie serwera, co oznacza, że użytkownicy nigdy nie mają bezpośredniego dostępu do plików źródłowych ani surowych danych. Wybór sprowadza się do tego, czy potrzebujesz statycznego wyświetlania, dynamicznego generowania z widoków Razor, czy pełnej interakcji użytkownika w samym pliku PDF. Szczegółowe porównanie biblioteki IronPDF z alternatywnymi bibliotekami można znaleźć w artykule "IronPDF vs iText".

Jakie są główne zalety tworzenia aplikacji z wykorzystaniem przeglądarki PDF po stronie serwera?

IronPDF przekształca aplikacje ASP.NET MVC w skuteczne systemy zarządzania dokumentami z pełnymi funkcjami przeglądarki PDF. Od podstawowego wyświetlania plików po zaawansowane funkcje, takie jak wypełnianie formularzy i wyszukiwanie tekstu, możesz stworzyć profesjonalną kontrolkę przeglądarki PDF MVC, która spełnia wymagania nowoczesnych aplikacji internetowych. Przetwarzanie po stronie serwera zapewnia spójne renderowanie na wszystkich platformach, przy jednoczesnym zachowaniu bezpieczeństwa i kontroli nad dokumentami PDF.

Niezależnie od tego, czy chcesz wyświetlać pliki PDF, tworzyć dynamiczne raporty, czy dodawać interaktywne elementy interfejsu użytkownika, IronPDF zapewnia narzędzia i dokumentację wspierające proces programowania. W przypadku wdrożeń Enterprise IronPDF oferuje szerokie wsparcie platform, w tym system Linux i kontenery Docker.

Chcesz wdrożyć własną przeglądarkę plików PDF dla ASP.NET MVC? Rozpocznij bezpłatny okres próbny i zapoznaj się z pełną dokumentacją. Aby zapoznać się z praktycznymi przykładami, zajrzyj do samouczków i przykładów kodu. Potrzebujesz funkcji dla Enterprise? Zapoznaj się z opcjami licencyjnymi, aby wybrać plan odpowiedni dla swojego zespołu.