IRONSOFTWAREHOME
KORZYSTANIE Z IRONPDF

Tworzenie PDF .NET (Przewodnik dla deweloperów z wykorzystaniem IronPDF)

Curtis Chau
Curtis Chau
Updated: 23 kwietnia 2026

Tworzenie przeglądarki plików PDF w ASP.NET Core nie powinno wymagać skomplikowanych bibliotek JavaScript ani wtyczek przeglądarek innych firm. Nowoczesne aplikacje internetowe potrzebują niezawodnego sposobu wyświetlania plików PDF bezpośrednio w przeglądarce, niezależnie od tego, czy chodzi o faktury, raporty czy interaktywne dokumenty PDF. IronPDF upraszcza ten proces, wykorzystując wbudowane funkcje przeglądarki do wyświetlania plików PDF, jednocześnie generując pliki PDF o idealnej rozdzielczości po stronie serwera.

W tym artykułe pokażemy, jak generować i przeglądać dokumenty PDF w ramach projektów ASP.NET Core, pokazując, jak tworzyć aplikacje do przeglądania plików PDF, które mogą wyświetlać dowolny plik PDF.

Czym jest przeglądarka plików PDF dla ASP.NET Core?

Przeglądarka plików PDF ASP.NET Core umożliwia użytkownikom przeglądanie dokumentów PDF bezpośrednio w aplikacjach internetowych bez konieczności pobierania plików na swoje urządzenie. Zamiast zmagać się z komponentami przeglądarki dokumentów opartymi na JavaScript, IronPDF stosuje zaskakująco proste podejście: generuje wysokiej jakości pliki PDF po stronie serwera przy użyciu silnika renderującego Chrome, a następnie udostępnia je z odpowiednimi nagłówkami, dzięki czemu przeglądarki automatycznie wyświetlają pliki PDF w trybie inline.

To podejście po stronie serwera oznacza, że przeglądarka plików PDF ASP.NET Core działa spójnie we wszystkich przeglądarkach bez dodatkowych wtyczek, takich jak Adobe Acrobat Reader. Ponieważ IronPDF korzysta z tego samego silnika Chrome, który napędza miliony przeglądarek, dokumenty PDF są renderowane dokładnie tak, jak zamierzono, z zachowaniem stylów CSS, interakcji JavaScript i złożonych układów. Integracja ASP.NET Core z formatem PDF obsługuje wszystko, od konwersji HTML do PDF po bezpieczne dostarczanie dokumentów, zapewniając długoterminowe wsparcie.

Jak zainstalować IronPDF w swojej aplikacji internetowej?

Zainstalowanie IronPDF w aplikacji internetowej .NET Core wymaga tylko jednego polecenia menedżera pakietów NuGet. Otwórz konsolę menedżera pakietów w Visual Studio i uruchom:

PM > Install-Package IronPdf

Po zainstalowaniu, skonfiguruj IronPDF w pliku Program.cs, aby ustawic klucz licencyjny:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"; // Start with a free trial key

Ta prosta konfiguracja zapewnia dostęp do pełnej funkcjonalności przeglądarki PDF IronPDF dla platformy .NET Core. Biblioteka automatycznie obsługuje wdrażanie silnika Chrome i zapewnia przejrzysty interfejs API do generowania i wyświetlania plików PDF w aplikacjach ASP.NET Core.

Jak stworzyć podstawową przeglądarkę dokumentów PDF?

Stworzenie pierwszej przeglądarki plików PDF w .NET Core wymaga minimalnej ilości kodu. Oto kontroler, który konwertuje zawartość HTML na dokument PDF do przeglądania:

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class PdfController : Controller
{
    public IActionResult ViewDocument()
    {
        var renderer = new ChromePdfRenderer();

        // Create PDF from HTML string
        var html = @"
            <html>
                <body style='font-family: Arial; padding: 20px;'>
                    <h1>Invoice #2024-001</h1>
                    <p>This PDF document is displayed directly in your browser.</p>
                    <table style='width: 100%; border-collapse: collapse;'>
                        <tr>
                            <td style='border: 1px solid #ddd; padding: 8px;'>Item</td>
                            <td style='border: 1px solid #ddd; padding: 8px;'>Price</td>
                        </tr>
                        <tr>
                            <td style='border: 1px solid #ddd; padding: 8px;'>Service</td>
                            <td style='border: 1px solid #ddd; padding: 8px;'>$99.00</td>
                        </tr>
                    </table>
                </body>
            </html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        // Return PDF for inline viewing
        Response.Headers.Add("Content-Disposition", "inline; filename=invoice.pdf");
        return File(pdf.BinaryData, "application/pdf");
    }
}

Klasa ChromePdfRenderer zajmuje sie przetwarzaniem konwersji, przeksztalcajac HTML w dokument PDF. Ustawienie naglowka Content-Disposition na "inline" informuje przegladarke, aby zamiast pobierania wyswietlala PDF, co tworzy plynne doswiadczenie przegladania PDF, gdzie uzytkownicy moga bezposrednio przegladac pliki PDF w aplikacji webowej.

Wygenerowany dokument PDF w przeglądarce

Jak stworzyc przegladarke PDF w ASP.NET Core: Rysunek 1 - PDF w naszej przegladarce PDF

Jak wyświetlać pliki PDF z różnych źródeł?

Przeglądarka plików PDF ASP.NET Core może generować pliki PDF z wielu źródeł pakietów. Oto jak przekonwertować adres URL na plik PDF do przeglądania:

public IActionResult ViewFromUrl(string websiteUrl)
{
    var renderer = new ChromePdfRenderer();

    // Configure rendering options
    renderer.RenderingOptions.EnableJavaScript = true;
    renderer.RenderingOptions.WaitFor.RenderDelay = 2000; // Wait for content to load
    var pdf = renderer.RenderUrlAsPdf(websiteUrl);
    Response.Headers.Add("Content-Disposition", "inline");
    return File(pdf.BinaryData, "application/pdf");
}

Wynik

Jak stworzyc przegladarke PDF w ASP.NET Core: Rysunek 2 - PDF wyrenderowany z URL i wyswietlony w naszym programie przegladarki PDF

W przypadku istniejących plików PDF przechowywanych na serwerze można je łatwo załadować i wyświetlić. Ten przykladowy kod pokazuje, jak pracowac z plikami w folderze wwwroot:

public IActionResult ViewExistingPdf(string fileName)
{
    // Load PDF from wwwroot folder
    var pdfPath = Path.Combine(_webHostEnvironment.WebRootPath, "documents", fileName);
    var pdf = PdfDocument.FromFile(pdfPath);   
    // Optional: Add modifications like watermarks
    pdf.ApplyWatermark("<h2 style='color: red; opacity: 0.5;'>CONFIDENTIAL</h2>");
    return File(pdf.BinaryData, "application/pdf");
}

Jak stworzyc przegladarke PDF w ASP.NET Core: Rysunek 3 - Przegladanie istniejacego PDF (z naszym dodanym znakiem wodnym)

Ta elastycznosc oznacza, ze Twoja przegladarka PDF moze obslugiwac zarowno dynamicznie generowana zawartosc, jak i istniejace dokumenty PDF przechowywane w folderze wwwroot lub bazie danych. Komponent płynnie integruje się z architekturą .NET Core.

Jak dodać zaawansowane funkcje przeglądarki PDF?

IronPDF przekształca podstawową przeglądarkę plików PDF w potężną przeglądarkę dokumentów z zaawansowanymi funkcjami. Dodanie formularzy do plików PDF umożliwia interaktywną funkcjonalność, którą użytkownicy mogą wypełniać bezpośrednio:

public IActionResult CreateFormPdf()
{
    var html = @"
        <html>
            <body>
                <h2>Application Form</h2>
                <form>
                    Name: 
                    <br><br>
                    Email: 
                    <br><br>
                    <input type='checkbox'> I agree to terms
                </form>
            </body>
        </html>";
    var renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.CreatePdfFormsFromHtml = true; // Enable form fields
    var pdf = renderer.RenderHtmlAsPdf(html);
    return File(pdf.BinaryData, "application/pdf");
}

Wynik z formularzem do wypełnienia

Jak stworzyc przegladarke PDF w ASP.NET Core: Rysunek 4

Gdy użytkownicy otworzą ten plik PDF w przeglądarce, będą mogli wypełnić formularze bezpośrednio, bez konieczności korzystania z zewnętrznych narzędzi. Można również edytować pliki PDF, dodając nagłówki, stopki, numery stron lub podpisy cyfrowe. Podejście oparte na tagach pomocniczych ułatwia dodawanie tych funkcji:

// Add headers and page numbers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center;'>Company Report</div>",
    MaxHeight = 25
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center;'>Page {page} of {total-pages}</div>",
    MaxHeight = 25
};

Funkcje te przekształcają przeglądarkę plików PDF ASP.NET w kompleksowe rozwiązanie do zarządzania dokumentami, obsługujące wszystko, od prostego wyświetlania po złożone operacje edycji, w tym zaznaczanie tekstu i funkcje PRINT. Dzięki funkcjom konwersji IronPDF możesz nawet pracować z innymi formatami, takimi jak pliki Excel, WORD, DOCX i PowerPoint.

Wnioski

Stworzenie przeglądarki plików PDF dla ASP.NET Core przy użyciu IronPDF eliminuje złożoność rozwiązań opartych na JavaScript, zapewniając jednocześnie profesjonalną obsługę dokumentów PDF. Wykorzystując natywne możliwości przeglądarki i silnik renderujący Chrome, można tworzyć, wyświetlać i zarządzać plikami PDF za pomocą zaledwie kilku wierszy kodu — bez konieczności stosowania domyślnych konfiguracji lub skomplikowanych ustawień.

Połączenie generowania po stronie serwera i przeglądania w przeglądarce zapewnia idealną równowagę między obsługą, wydajnością i komfortem użytkowania aplikacji internetowych. Niezależnie od tego, czy chcesz wyświetlać pliki PDF, obsługiwać formularze, edytować istniejące dokumenty czy drukować pliki PDF, proste API IronPDF ułatwia wdrożenie. Biblioteka jest często aktualizowana w celu zapewnienia zgodności z najnowszymi .NET Frameworkami i środowiskami Windows.

Chcesz stworzyć własną przeglądarkę plików PDF w swoim projekcie ASP.NET Core? Zacznij od bezpłatnej wersji próbnej, aby znaleźć odpowiedni plan. Potrzebujesz pomocy na początek? Zapoznaj się z tym szczegółowym samouczkiem lub przejrzyj pełną dokumentację, aby uzyskać więcej przykładów.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Powiązane artykuły

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Your trial license will be sent to your email address

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta