Jak przekonwertować PDF na tablicę bajtów w C#

Instalacja iText

Aby dodac iText do projektu ASP.NET Core MVC, zainstaluj pakiet NuGet uzywajac Konsoli Menedzera Pakietów:

Install-Package iTextSharp

Install-Package iTextSharp

Podstawowa implemantacja z iText

Oto pełny przykład pokazujący, jak przekonwertować widok MVC na PDF, używając klasy XMLWorkerHelper iText w projekcie ASP.NET MVC:

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Niew.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";

        // Create PDF document using iTextSharp
        using var stream = new MemoryStream();
        var document = new Document(PageSize.A4);
        PdfWriter writer = PdfWriter.GetInstance(document, stream);
        document.Open();

        using (var srHtml = new StringReader(invoiceHtml))
        {
            XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
        }

        document.Close();

        // Return the PDF file
        return new FileContentResult(stream.ToArray(), "application/pdf")
        {
            FileDownloadName = "invoice.pdf"
        };
    }
}

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Niew.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";

        // Create PDF document using iTextSharp
        using var stream = new MemoryStream();
        var document = new Document(PageSize.A4);
        PdfWriter writer = PdfWriter.GetInstance(document, stream);
        document.Open();

        using (var srHtml = new StringReader(invoiceHtml))
        {
            XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
        }

        document.Close();

        // Return the PDF file
        return new FileContentResult(stream.ToArray(), "application/pdf")
        {
            FileDownloadName = "invoice.pdf"
        };
    }
}

Imports iTextSharp.text
Imports iTextSharp.tool.xml
Imports iTextSharp.text.pdf
Imports System.IO

Public Class HomeController
    Inherits Controller

    Public Function Index() As ActionResult
        Return View()
    End Function

    Public Function GeneratePDF() As ActionResult
        ' Create a simple invoice HTML
        Dim invoiceHtml As String = "
            <h1>Invoice #1001</h1>
            <p>Date: " & DateTime.Now.ToString("MM/dd/yyyy") & "</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>"

        ' Create PDF document using iTextSharp
        Using stream As New MemoryStream()
            Dim document As New Document(PageSize.A4)
            Dim writer As PdfWriter = PdfWriter.GetInstance(document, stream)
            document.Open()

            Using srHtml As New StringReader(invoiceHtml)
                XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml)
            End Using

            document.Close()

            ' Return the PDF file
            Return New FileContentResult(stream.ToArray(), "application/pdf") With {
                .FileDownloadName = "invoice.pdf"
            }
        End Using
    End Function
End Class

Ten przykład tworzy podstawowy dokument PDF na podstawie treści HTML. Klasa XMLWorkerHelper przetwarza ciąg HTML i dodaje elementy do dokumentu PDF, używając modelu obiektowego. Klasa PdfWriter obsługuje właściwy proces generowania PDF, podczas gdy Document zarządza strukturą strony.

Wynik

Jakie są kluczowe ograniczenia iText?

Klasa XMLWorkerHelper obsługuje podstawowe tagi HTML i wbudowany CSS. Niewoczesne właściwości CSS3, układy flexbox i systemy siatek nie są renderowane. Treści zależne od JavaScriptu znikają całkowicie. Złożone style, takie jak gradienty, cienie i transformacje, są ignorowane. Nawet standardowe klasy Bootstrap nie mają tu zastosowania, przez co starannie zaprojektowane widoki wyglądają na proste i nieprofesjonalne.

Wielu programistów zglasza te ograniczenia na Stack Overflow, co prowadzi do frustracji podczas prób konwersji widoków MVC na PDF za pomocą iText.

Być może bardziej niepokojący jest model licencyjny iText. Biblioteka korzysta z licencji AGPL, która wymaga udostępnienia całej aplikacji na zasadach open source w przypadku korzystania z wersji darmowej. Ceny licencji komercyjnych zaczynają się od kilku tysięcy dolarów rocznie, co dla wielu firm jest zbyt wysokim kosztem. To ograniczenie licencyjne skłoniło wielu programistów do poszukiwania alternatyw, które lepiej odpowiadają potrzebom komercyjnego programowania. Jak wspomniano w dokumentacji platformy .NET firmy Microsoft, wybór bibliotek z odpowiednimi licencjami ma kluczowe znaczenie dla projektów komercyjnych.

Jak zainstalować IronPDF?

Dodaj IronPDF do swojego projektu za pomocą konsoli NuGet Package Manager:

Install-Package IronPdf

Niewoczesna implementacja z wykorzystaniem IronPDF

Ta sama faktura, utworzona powyżej, wykorzystuje teraz nowoczesny CSS i pełne renderowanie HTML5 za pomocą ChromePdfRenderer firmy IronPDF:

using IronPdf;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Niew.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";

        // Use Chromium engine for rendering
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);

        // Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");

        // Return the PDF file with binary data
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

using IronPdf;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Niew.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";

        // Use Chromium engine for rendering
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);

        // Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");

        // Return the PDF file with binary data
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

Imports IronPdf

Public Class HomeController
    Inherits Controller

    Public Function Index() As ActionResult
        Return View()
    End Function

    Public Function GenerateModernPDF() As ActionResult
        ' Create a styled invoice HTML with modern CSS
        Dim invoiceHtml As String = "
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " & DateTime.Now.ToString("MMMM dd, yyyy") & "</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>"

        ' Use Chromium engine for rendering
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(invoiceHtml)

        ' Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf")

        ' Return the PDF file with binary data
        Return New FileContentResult(pdf.BinaryData, "application/pdf")
    End Function
End Class

ChromePdfRenderer konwertuje HTML dokładnie tak, jak wyświetliłby to Chrome. Tła z gradientem, nowoczesne czcionki i wyrafinowana stylistyka są renderowane poprawnie. Silnik renderowania obsługuje złożone właściwości CSS, które iText nie może przetworzyć, w tym flexbox, układy siatki i transformacje CSS renderowane jako statyczne klatki. RenderHtmlAsPdf metoda sprawia, że konwersja HTML na PDF w MVC jest prosta.

Wynik

Bezpłatna próba i poznaj nowoczesne generowanie plików PDF dzięki silnikowi renderowania opartemu na przeglądarce Chrome.

Porównanie funkcji

Kwestie licencyjne

Różnice w licencjonowaniu tych bibliotek mają znaczący wpływ na komercyjne tworzenie oprogramowania. Licencja AGPL iText tworzy zobowiązania prawne, których wiele firm nie może zaakceptować. Korzystanie z wersji darmowej wymaga udostępnienia całej aplikacji na licencji open source, w tym zastrzeżonej logiki biznesowej. To ograniczenie sprawia, że iText nie nadaje się do większości projektów komercyjnych, chyba że zakupisz kosztowną licencję komercyjną.

IronPDF oferuje proste licencjonowanie komercyjne zaczynając od $999 dla jednego dewelopera. Licencja obejmuje rok aktualizacji i wsparcia technicznego, bez obowiązku udostępniania aplikacji na licencji open source. Ten przejrzysty model cenowy jest dostosowany do typowych budżetów na tworzenie oprogramowania, dzięki czemu profesjonalne generowanie plików PDF jest dostępne dla firm każdej wielkości podczas konwersji widoków MVC do formatu PDF w języku C#.

Analiza jakości wyników

Różnica w jakości renderowania staje się natychmiast widoczna po porównaniu wyników. iText produkuje podstawowe PDF, które przypominają dokumenty z początku lat 2000. Tabele nie mają odpowiedniego stylu, czcionki domyślnie przyjmują standardy systemowe, a nowoczesne elementy projektu całkowicie znikają. Powstałe pliki PDF wyglądają nieprofesjonalnie i nie pasują do wizerunku marki Twojej aplikacji.

IronPDF generuje pliki PDF o idealnej rozdzielczości, które pasują do Twojego projektu strony internetowej. Gradienty są renderowane dokładnie, niestandardowe czcionki wyświetlają się poprawnie, a złożone układy zachowują swoją strukturę. Silnik Chromium zapewnia, że pliki PDF wyglądają identycznie jak w widoku internetowym, zachowując tożsamość marki i profesjonalny wygląd we wszystkich generowanych dokumentach.

Nagłówki i stopki

Dodaj profesjonalne nagłówki i stopki z dynamiczną treścią:

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

Dim renderer = New ChromePdfRenderer With {
    .RenderingOptions = New ChromePdfRenderOptions With {
        .HtmlHeader = New HtmlHeaderFooter With {
            .MaxHeight = 25,
            .HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        .HtmlFooter = New HtmlHeaderFooter With {
            .MaxHeight = 20,
            .HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
}

Ta konfiguracja zapewnia spójny wizerunek marki na każdej stronie. Podstawiciele {page} i {total-pages} automatycznie uzupełniają się poprawnymi wartościami, zapewniając dokładne paginowanie w całym dokumencie. Aby uzyskać więcej opcji konfiguracyjnych, zapoznaj się z przewodnikiem dotyczącym nagłówków i stopek.

Bezpieczeństwo i szyfrowanie

Chroń poufne dokumenty za pomocą haseł i uprawnień, korzystając z funkcji bezpieczeństwa IronPDF:

var pdf = renderer.RenderHtmlAsPdf(html);

// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";

// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

var pdf = renderer.RenderHtmlAsPdf(html);

// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";

// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

Dim pdf = renderer.RenderHtmlAsPdf(html)

' Add password protection
pdf.SecuritySettings.UserPassword = "user123"
pdf.SecuritySettings.OwnerPassword = "owner456"

' Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights
pdf.SecuritySettings.AllowUserCopyPasteContent = False

Te ustawienia zabezpieczeń zapobiegają nieautoryzowanemu dostępowi i kontrolują sposób, w jaki odbiorcy mogą korzystać z plików PDF po konwersji widoków MVC do formatu PDF. Możesz ograniczyć drukowanie, kopiowanie i edycję, zachowując pełną kontrolę właściciela. Więcej informacji można znaleźć w dokumentacji dotyczącej zabezpieczeń w formacie PDF.

Wynik

Obsługa pól formularzy

IronPDF konwertuje formularze HTML na interaktywne formularze PDF bez konieczności stosowania dodatkowych narzędzi:

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";

var pdf = renderer.RenderHtmlAsPdf(formHtml);

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";

var pdf = renderer.RenderHtmlAsPdf(formHtml);

Imports System

Dim formHtml As String = "
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>"

Dim pdf = renderer.RenderHtmlAsPdf(formHtml)

Wynikowy plik PDF zachowuje interaktywność formularza, umożliwiając użytkownikom wypełnianie pól bezpośrednio w czytniku PDF. Ta funkcja eliminuje potrzebę stosowania oddzielnych narzędzi do tworzenia formularzy, upraszczając przepływ pracy z dokumentami. Przeglądaj dokumentację formularzy dla dalszych opcji.

Wynik

Optymalizacja renderowania CSS

Aby uzyskać najlepsze wyniki przy złożonym CSS podczas konwersji plików HTML do formatu PDF, użyj zapytań o media drukowane:

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

To ustawienie stosuje reguły CSS specyficzne dla druku, optymalizując układy pod kątem wydruku PDF, a nie wyświetlania na ekranie. Połączenie tego z arkuszami stylów zoptymalizowanymi pod kątem druku zapewnia precyzyjną kontrolę nad podziałami stron, marginesami i typografią. Przewodnik po typach mediów CSS wyjaśnia dodatkowe opcje renderowania.

Czas wykonywania kodu JavaScript

Podczas konwersji treści dynamicznych należy poczekać na zakończenie wykonywania kodu JavaScript przed zapisaniem pliku PDF. Gwarantuje to, że wszystkie wywołania AJAX i operacje na DOM zostaną zakończone:

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

Ta konfiguracja gwarantuje, że wywołania AJAX zostaną zakończone, a operacje na DOM zakończą się przed rozpoczęciem generowania pliku PDF, co pozwala uchwycić w pełni wyrenderowany stan widoku MVC. W przypadku bibliotek wykresów i innych treści intensywnie wykorzystujących asynchroniczność może być konieczne zwiększenie wartości opóźnienia.

Wynik

Osadzanie czcionek i formatowanie dokumentów

Upewnij się, że niestandardowe czcionki wyświetlają się poprawnie, osadzając je bezpośrednio w kodzie HTML za pomocą adresów URI danych zakodowanych w base64:

@font-face {
    font-family: 'CustomFont';
    src: url(data:font/woff2;base64,[base64-encoded-font]) format('woff2');
}

Osadzenie czcionek bezpośrednio w kodzie HTML gwarantuje spójne renderowanie we wszystkich środowiskach, eliminując problemy z brakującymi czcionkami w generowanych dokumentach PDF. To podejście działa równie dobrze, niezależnie od tego, czy użyjesz renderowania opartego na URL przez RenderUrlAsPdf, czy renderowania opartego na ciągu przez RenderHtmlAsPdf.

Aby uzyskać informacje na temat dodatkowych wzorców konfiguracji, w tym rozmiaru strony, orientacji i kontroli marginesów, zapoznaj się z dokumentacją opcji renderowania IronPDF. Możesz również przejrzeć przykładowe projekty na GitHubie, które pokazują typowe wzorce integracji MVC.