Jak stworzyć dokumenty PDF w .NET z IronPDF

Jak zainstalować IronPDF w projekcie ASP.NET?

Otwórz konsolę menedżera pakietów w Visual Studio i uruchom następujące polecenie, aby zainstalować IronPDF:

Install-Package IronPdf

Po zainstalowaniu pakietu dodaj dyrektywe using IronPdf; do swoich plikow C#. IronPDF jest przeznaczony dla platformy .NET 8 i nowszych, dzięki czemu jest kompatybilny z ASP.NET Core, ASP.NET Framework 4.6.2+ oraz nowoczesnymi projektami usług typu worker. Nie są wymagane żadne dodatkowe komponenty uruchomieniowe ani licencje Microsoft Office.

Przed uruchomieniem w srodowisku produkcyjnym, ustaw swoj klucz licencyjny raz podczas startu aplikacji -- na przyklad na poczatku Program.cs. Mozesz odczytac klucz z appsettings.json, aby trzymac dane uwierzytelniajace poza kontrola wersji: IronPdf.License.LicenseKey = configuration["IronPdf:LicenseKey"]!;.

Jak przekonwertowac dokument Word do PDF w C#?

Klasa DocxToPdfRenderer jest punktem wejscia do wszystkich konwersji Word do PDF. Akceptuje sciezke do pliku, tablice bajtow lub Stream i zwraca obiekt PdfDocument, ktory mozna zapisac, zaszyfrowac, polaczyc lub bezposrednio udostepnic przez HTTP.

Oto najprostsza możliwa konwersja:

using IronPdf;

// Set license key before first use
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("report.docx");
pdf.SaveAs("report.pdf");

using IronPdf;

// Set license key before first use
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("report.docx");
pdf.SaveAs("report.pdf");

Imports IronPdf

' Set license key before first use
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim pdf = renderer.RenderDocxAsPdf("report.docx")
pdf.SaveAs("report.pdf")

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using var docxStream = new FileStream("document.docx", FileMode.Open);
var renderer = new DocxToPdfRenderer();
var pdfDocument = renderer.RenderDocxAsPdf(docxStream);
pdfDocument.SaveAs("output.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using var docxStream = new FileStream("document.docx", FileMode.Open);
var renderer = new DocxToPdfRenderer();
var pdfDocument = renderer.RenderDocxAsPdf(docxStream);
pdfDocument.SaveAs("output.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Using docxStream As New FileStream("document.docx", FileMode.Open)
    Dim renderer As New DocxToPdfRenderer()
    Dim pdfDocument = renderer.RenderDocxAsPdf(docxStream)
    pdfDocument.SaveAs("output.pdf")
End Using

Jak przekonwertować wiele plików DOCX w trybie wsadowym?

Kiedy potrzebujesz przetworzyc caly folder dokumentow, iteruj po plikach i uzywaj jednej instancji DocxToPdfRenderer. Ponowne wykorzystanie renderera pozwala uniknąć obciążenia związanego z powtarzającą się inicjalizacją:

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
string[] docxFiles = Directory.GetFiles(@"C:\WordDocuments", "*.docx");

foreach (string docxFile in docxFiles)
{
    var pdf = renderer.RenderDocxAsPdf(docxFile);
    string pdfPath = Path.ChangeExtension(docxFile, ".pdf");
    pdf.SaveAs(pdfPath);
    Console.WriteLine($"Converted: {Path.GetFileName(pdfPath)}");
}

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
string[] docxFiles = Directory.GetFiles(@"C:\WordDocuments", "*.docx");

foreach (string docxFile in docxFiles)
{
    var pdf = renderer.RenderDocxAsPdf(docxFile);
    string pdfPath = Path.ChangeExtension(docxFile, ".pdf");
    pdf.SaveAs(pdfPath);
    Console.WriteLine($"Converted: {Path.GetFileName(pdfPath)}");
}

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim docxFiles As String() = Directory.GetFiles("C:\WordDocuments", "*.docx")

For Each docxFile As String In docxFiles
    Dim pdf = renderer.RenderDocxAsPdf(docxFile)
    Dim pdfPath As String = Path.ChangeExtension(docxFile, ".pdf")
    pdf.SaveAs(pdfPath)
    Console.WriteLine($"Converted: {Path.GetFileName(pdfPath)}")
Next

Jak używać korespondencji seryjnej do generowania spersonalizowanych plików PDF?

Funkcja korespondencji seryjnej pozwala zdefiniować szablon DOCX z symbolami zastępczymi, a następnie wypełnić te symbole danymi w czasie wykonywania. Ten wzorzec jest idealny dla faktur, umów, certyfikatów i wszelkich dokumentów, w których struktura jest stała, ale treść różni się w zależności od odbiorcy.

DocxToPdfRenderer IronPDF akceptuje DataTable, Dictionary<string, string>, lub dostosowane zrodlo danych poprzez wlasciwosc MailMergeDataSource:

using IronPdf;
using System.Data;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Build the data source
var data = new DataTable();
data.Columns.Add("CustomerName");
data.Columns.Add("InvoiceNumber");
data.Columns.Add("TotalAmount");
data.Rows.Add("Acme Corp", "INV-2026-001", "$4,500.00");

var renderer = new DocxToPdfRenderer();
renderer.MailMergeDataSource = data;

var pdf = renderer.RenderDocxAsPdf("invoice_template.docx");
pdf.SaveAs("acme_invoice.pdf");

using IronPdf;
using System.Data;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Build the data source
var data = new DataTable();
data.Columns.Add("CustomerName");
data.Columns.Add("InvoiceNumber");
data.Columns.Add("TotalAmount");
data.Rows.Add("Acme Corp", "INV-2026-001", "$4,500.00");

var renderer = new DocxToPdfRenderer();
renderer.MailMergeDataSource = data;

var pdf = renderer.RenderDocxAsPdf("invoice_template.docx");
pdf.SaveAs("acme_invoice.pdf");

Imports IronPdf
Imports System.Data

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

' Build the data source
Dim data As New DataTable()
data.Columns.Add("CustomerName")
data.Columns.Add("InvoiceNumber")
data.Columns.Add("TotalAmount")
data.Rows.Add("Acme Corp", "INV-2026-001", "$4,500.00")

Dim renderer As New DocxToPdfRenderer()
renderer.MailMergeDataSource = data

Dim pdf = renderer.RenderDocxAsPdf("invoice_template.docx")
pdf.SaveAs("acme_invoice.pdf")

W szablonie DOCX otocz kazda nazwe pola podwojnymi nawiasami (np. <<CustomerName>>), aby oznaczyc pola laczenia. W momencie konwersji IronPDF zastępuje każdy symbol zastępczy odpowiednią wartością z kolumny źródła danych. Więcej informacji na temat wzorców automatyzacji dokumentów można znaleźć w dokumentacji funkcji korespondencji seryjnej programu WORD.

Jak zabezpieczyć plik PDF po konwersji z formatu DOCX?

Po konwersji mozna bezposrednio zastosowac ochrone haslem i ograniczenia uprawnien na obiekcie PdfDocument przed zapisaniem. Jest to przydatne podczas dystrybucji raportów finansowych, umów prawnych lub wszelkich dokumentów, których nie należy swobodnie kopiować ani drukować:

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("confidential.docx");

// Require a password to open the file
pdf.SecuritySettings.UserPassword = "user123";

// Owner password allows overriding restrictions
pdf.SecuritySettings.OwnerPassword = "owner456";

// Restrict printing and content copying
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SaveAs("secured_document.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("confidential.docx");

// Require a password to open the file
pdf.SecuritySettings.UserPassword = "user123";

// Owner password allows overriding restrictions
pdf.SecuritySettings.OwnerPassword = "owner456";

// Restrict printing and content copying
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SaveAs("secured_document.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim pdf = renderer.RenderDocxAsPdf("confidential.docx")

' Require a password to open the file
pdf.SecuritySettings.UserPassword = "user123"

' Owner password allows overriding restrictions
pdf.SecuritySettings.OwnerPassword = "owner456"

' Restrict printing and content copying
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint
pdf.SecuritySettings.AllowUserCopyPasteContent = False

pdf.SaveAs("secured_document.pdf")

Jak zintegrować konwersję plików DOCX do PDF w kontrolerze ASP.NET Core?

Aby udostępnić konwersję z formatu WORD do PDF jako punkt końcowy HTTP, należy wstawić logikę konwersji do akcji kontrolera. Poniższy przykład akceptuje przesyłanie formularza wieloczęściowego, konwertuje plik w pamięci i zwraca plik PDF jako plik do pobrania:

using IronPdf;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class DocumentController : ControllerBase
{
    [HttpPost("convert")]
    public IActionResult ConvertWordToPdf(IFormFile wordFile)
    {
        if (wordFile == null || wordFile.Length == 0)
            return BadRequest("Please upload a valid Word document.");

        using var stream = new MemoryStream();
        wordFile.CopyTo(stream);

        var renderer = new DocxToPdfRenderer();
        var pdfDocument = renderer.RenderDocxAsPdf(stream.ToArray());

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

using IronPdf;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class DocumentController : ControllerBase
{
    [HttpPost("convert")]
    public IActionResult ConvertWordToPdf(IFormFile wordFile)
    {
        if (wordFile == null || wordFile.Length == 0)
            return BadRequest("Please upload a valid Word document.");

        using var stream = new MemoryStream();
        wordFile.CopyTo(stream);

        var renderer = new DocxToPdfRenderer();
        var pdfDocument = renderer.RenderDocxAsPdf(stream.ToArray());

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

Imports IronPdf
Imports Microsoft.AspNetCore.Http
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/[controller]")>
Public Class DocumentController
    Inherits ControllerBase

    <HttpPost("convert")>
    Public Function ConvertWordToPdf(wordFile As IFormFile) As IActionResult
        If wordFile Is Nothing OrElse wordFile.Length = 0 Then
            Return BadRequest("Please upload a valid Word document.")
        End If

        Using stream As New MemoryStream()
            wordFile.CopyTo(stream)

            Dim renderer As New DocxToPdfRenderer()
            Dim pdfDocument = renderer.RenderDocxAsPdf(stream.ToArray())

            Return File(pdfDocument.BinaryData, "application/pdf", "converted.pdf")
        End Using
    End Function
End Class

try
{
    var pdf = renderer.RenderDocxAsPdf(stream.ToArray());
    return File(pdf.BinaryData, "application/pdf", "output.pdf");
}
catch (IronPdfException ex)
{
    // Log the exception and return a 422 Unprocessable Entity
    return UnprocessableEntity($"Conversion failed: {ex.Message}");
}

try
{
    var pdf = renderer.RenderDocxAsPdf(stream.ToArray());
    return File(pdf.BinaryData, "application/pdf", "output.pdf");
}
catch (IronPdfException ex)
{
    // Log the exception and return a 422 Unprocessable Entity
    return UnprocessableEntity($"Conversion failed: {ex.Message}");
}

Try
    Dim pdf = renderer.RenderDocxAsPdf(stream.ToArray())
    Return File(pdf.BinaryData, "application/pdf", "output.pdf")
Catch ex As IronPdfException
    ' Log the exception and return a 422 Unprocessable Entity
    Return UnprocessableEntity($"Conversion failed: {ex.Message}")
End Try

Jak połączyć przekonwertowany plik PDF z istniejącym dokumentem?

Typowy przebieg pracy obejmuje konwersję listu przewodniego w formacie DOCX, a następnie dołączenie go na początku istniejącego raportu w formacie PDF. Dzięki funkcji łączenia plików PDF w IronPDF wystarczy jedno zdanie:

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var coverLetter = renderer.RenderDocxAsPdf("cover_letter.docx");
var existingReport = PdfDocument.FromFile("annual_report.pdf");

// Merge cover letter (first) with existing report (second)
var merged = PdfDocument.Merge(coverLetter, existingReport);
merged.SaveAs("final_document.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var coverLetter = renderer.RenderDocxAsPdf("cover_letter.docx");
var existingReport = PdfDocument.FromFile("annual_report.pdf");

// Merge cover letter (first) with existing report (second)
var merged = PdfDocument.Merge(coverLetter, existingReport);
merged.SaveAs("final_document.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim coverLetter As PdfDocument = renderer.RenderDocxAsPdf("cover_letter.docx")
Dim existingReport As PdfDocument = PdfDocument.FromFile("annual_report.pdf")

' Merge cover letter (first) with existing report (second)
Dim merged As PdfDocument = PdfDocument.Merge(coverLetter, existingReport)
merged.SaveAs("final_document.pdf")

Mozesz laczyc tak wiele obiektow PdfDocument, jak potrzeba, przekazujac kolekcje do PdfDocument.Merge. W przypadku bardziej zaawansowanych scenariuszy tworzenia dokumentów warto rozważyć dodawanie stron do istniejącego pliku PDF lub umieszczanie znaków wodnych na przekonwertowanym pliku wyjściowym.

Jak dodać znaki wodne lub nagłówki do przekonwertowanych plików PDF?

Po konwersji pliku DOCX można dodać niestandardowe nagłówki, stopki i stemple tekstowe do każdej strony. Jest to przydatne do dodawania statusu zatwierdzenia, informacji o poufności lub oznaczeń marki do generowanych dokumentów:

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("proposal.docx");

// Add a text stamp on every page
pdf.ApplyStamp(new TextStamp("DRAFT", new TextStampStyle
{
    FontSize = 36,
    FontColor = IronSoftware.Drawing.Color.FromArgb(100, 200, 0, 0),
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center,
    Rotation = -45
}));

pdf.SaveAs("proposal_draft.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("proposal.docx");

// Add a text stamp on every page
pdf.ApplyStamp(new TextStamp("DRAFT", new TextStampStyle
{
    FontSize = 36,
    FontColor = IronSoftware.Drawing.Color.FromArgb(100, 200, 0, 0),
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center,
    Rotation = -45
}));

pdf.SaveAs("proposal_draft.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim pdf = renderer.RenderDocxAsPdf("proposal.docx")

' Add a text stamp on every page
pdf.ApplyStamp(New TextStamp("DRAFT", New TextStampStyle With {
    .FontSize = 36,
    .FontColor = IronSoftware.Drawing.Color.FromArgb(100, 200, 0, 0),
    .VerticalAlignment = VerticalAlignment.Middle,
    .HorizontalAlignment = HorizontalAlignment.Center,
    .Rotation = -45
}))

pdf.SaveAs("proposal_draft.pdf")

W przypadku nagłówków i stopek opartych na HTML, zawierających numery stron, zapoznaj się z dokumentacją dotyczącą nagłówków i stopek IronPDF.

Jak wypada IronPDF na tle innych bibliotek do konwersji plików WORD na PDF?

W środowisku .NET istnieje kilka bibliotek służących do konwersji plików DOCX do formatu PDF. Zrozumienie kompromisów pomoże Ci wybrać odpowiednie narzędzie do Twojego zastosowania.

Telerik Document Processing (RadWordsProcessing) obsługuje konwersję plików DOCX do formatu PDF i jest częścią Suite Telerik. Działa całkowicie w kodzie zarządzanym i nie wymaga natywnych zależności, ale jego wierność renderowania w przypadku złożonych układów może różnić się od programu WORD. Aspose.Words to kolejna sprawdzona opcja o wysokiej jakości i bogatym API, choć wiąże się z kosztem licencji na programistę podobnym do IronPDF.

Jeśli chodzi o alternatywy open source, DocX firmy Xceed umożliwia edycję plików DOCX, ale nie oferuje bezpośredniej konwersji do formatu PDF. Programiści, którzy potrzebują opcji bez zależności w systemie Linux, mogą również rozważyć LibreOffice bezinterfejsowy wywoływany z procesu, choć wiąże się to z dużą zależnością binarną i obciążeniem związanym z uruchamianiem procesów.

Główną zaletą IronPDF w tym porównaniu jest połączenie wysokiej jakości, braku zależności od natywnego pakietu Office, obsługi systemu Linux oraz prostej instalacji opartej na NuGet. Dla zespołów, które już korzystają z licencji IronPDF do konwersji HTML na PDF, renderer DOCX jest dostępny bez dodatkowych kosztów.

Jakie są Twoje kolejne kroki?

Masz teraz solidną podstawę do konwersji dokumentów WORD do formatu PDF w dowolnej aplikacji .NET lub ASP.NET. Oto, co warto sprawdzić dalej:

• Pobierz i wypróbuj IronPDF — zacznij od bezpłatnej wersji próbnej, aby przetestować pełny zestaw funkcji w swoim własnym projekcie przed zakupem licencji.
• Przeczytaj przewodnik po konwersji plików DOCX — artykuł instruktażowy dotyczący DocxToPdfRenderer szczegółowo omawia skrajne przypadki, opcje zaawansowane oraz optymalizację wydajności.
• Poznaj funkcję konwersji HTML do PDF — jeśli Twój proces pracy obejmuje szablony HTML lub widoki Razor, IronPDF może konwertować HTML do PDF przy użyciu tego samego płynnego interfejsu API.
• Łączenie i dzielenie dokumentów — dowiedz się, jak połączyć wiele plików PDF w jeden plik lub podzielić duży plik PDF na poszczególne strony.
• Dodawanie podpisów cyfrowych — w przypadku procesów prawnych lub związanych z zapewnieniem zgodności z przepisami IronPDF obsługuje cyfrowe podpisy PDF przy użyciu certyfikatów X.509.
• Zapoznaj się z opcjami licencyjnymi — sprawdź licencje na programistę, na witrynę i Licencjonowanie OEM, aby znaleźć plan pasujący do Twojego modelu wdrożenia.
• Przeglądaj bloga — blog IronPDF zawiera samouczki dotyczące generowania plików PDF, ich edycji, integracji OCR i nie tylko.