Word zu PDF ASP.NET – DOCX in C# in PDF konvertieren

Wie installiert man IronPDF in einem ASP.NET -Projekt?

Öffnen Sie die Paket-Manager-Konsole in Visual Studio und führen Sie den folgenden Befehl aus, um IronPDF zu installieren:

Install-Package IronPdf
dotnet add package IronPdf

Install-Package IronPdf
dotnet add package IronPdf

Sobald das Paket installiert ist, fügen Sie eine using IronPdf;-Direktive zu Ihren C#-Dateien hinzu. IronPDF zielt auf .NET 8 und höher ab und ist somit kompatibel mit ASP.NET Core, ASP.NET Framework 4.6.2+ und modernen Worker-Service-Projekten. Es werden keine zusätzlichen Laufzeitkomponenten oder Microsoft Office-Lizenzen benötigt.

Vor dem Produktivbetrieb müssen Sie Ihren Lizenzschlüssel einmalig beim Start der Anwendung festlegen – zum Beispiel ganz oben in Program.cs. Den Schlüssel zum Schutz der Zugangsdaten vor der Quellcodeverwaltung können Sie aus appsettings.json lesen: IronPdf.License.LicenseKey = configuration["IronPdf:LicenseKey"]!;.

Wie konvertiert man ein Word-Dokument in C# in ein PDF?

Die Klasse DocxToPdfRenderer ist der Einstiegspunkt für alle Word-zu-PDF-Konvertierungen. Es akzeptiert einen Dateipfad, ein Byte-Array oder ein Stream und gibt ein PdfDocument-Objekt zurück, das Sie speichern, verschlüsseln, zusammenführen oder direkt über HTTP bereitstellen können.

Hier ist die einfachste mögliche Umrechnung:

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

Wie konvertiert man mehrere DOCX-Dateien gleichzeitig?

Wenn Sie einen ganzen Ordner mit Dokumenten verarbeiten müssen, durchlaufen Sie die Dateien und verwenden Sie eine einzelne DocxToPdfRenderer-Instanz wieder. Durch die Wiederverwendung des Renderers wird der wiederholte Initialisierungsaufwand vermieden:

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

Wie erstellt man mit der Serienbrieffunktion personalisierte PDFs?

Mit der Serienbrieffunktion können Sie eine DOCX-Vorlage mit Platzhaltern definieren und diese Platzhalter dann zur Laufzeit mit Daten füllen. Dieses Verfahren eignet sich ideal für Rechnungen, Verträge, Zertifikate und alle Dokumente, deren Struktur feststeht, deren Inhalt aber je nach Empfänger variiert.

IronPDFs DocxToPdfRenderer akzeptiert eine DataTable, eine Dictionary<string, string> oder eine benutzerdefinierte Datenquelle über die MailMergeDataSource Eigenschaft:

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

Umgeben Sie in der DOCX-Vorlage jeden Feldnamen mit doppelten Chevron-Zeichen (z. B. <<CustomerName>>), um die Seriendruckfelder zu kennzeichnen. Bei der Konvertierung ersetzt IronPDF jeden Platzhalter durch den entsprechenden Spaltenwert aus der Datenquelle. Mehr über Muster zur Dokumentenautomatisierung erfahren Sie in der Dokumentation zum Serienbriefversand in Microsoft Word .

Wie sichert man eine PDF-Datei nach der Konvertierung von DOCX?

Nach der Konvertierung können Sie vor dem Speichern direkt auf das PdfDocument-Objekt einen Passwortschutz und Berechtigungseinschränkungen anwenden. Dies ist nützlich beim Verteilen von Finanzberichten, Rechtsverträgen oder Dokumenten, die nicht frei kopiert oder ausgedruckt werden sollten:

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

Wie integriert man die DOCX-zu-PDF-Konvertierung in einen ASP.NET Core Controller?

Um die Word-zu-PDF-Konvertierung als HTTP-Endpunkt bereitzustellen, fügen Sie die Konvertierungslogik in eine Controller-Aktion ein. Das folgende Beispiel akzeptiert einen Multipart-Formular-Upload, konvertiert die Datei im Speicher und gibt die PDF-Datei als herunterladbare Antwort zurück:

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

Wie fügt man eine konvertierte PDF-Datei in ein bestehendes Dokument ein?

Ein gängiger Arbeitsablauf besteht darin, ein DOCX-Anschreiben zu konvertieren und es dann einem bestehenden PDF-Bericht voranzustellen. Dank der PDF-Zusammenführungsfunktion von IronPDF ist dies mit einer einzigen Zeile Code erledigt:

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

Sie können beliebig viele PdfDocument Objekte zusammenführen, indem Sie eine Sammlung an PdfDocument.Merge übergeben. Für komplexere Szenarien der Dokumentenerstellung empfiehlt es sich, Seiten zu einem bestehenden PDF hinzuzufügen oder Wasserzeichen auf die konvertierte Ausgabedatei einzufügen .

Wie fügt man Wasserzeichen oder Kopfzeilen zu konvertierten PDFs hinzu?

Nach der Konvertierung einer DOCX-Datei können Sie jeder Seite benutzerdefinierte Kopf- und Fußzeilen sowie Textstempel hinzufügen. Dies ist nützlich, um generierten Dokumenten Genehmigungsstatus, Vertraulichkeitshinweise oder Branding hinzuzufügen:

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

Informationen zu HTML-basierten Kopf- und Fußzeilen, die Seitenzahlen enthalten, finden Sie in der IronPDF Dokumentation zu Kopf- und Fußzeilen .

Wie vergleicht man IronPDF mit alternativen Word-zu-PDF-Bibliotheken?

Es gibt mehrere Bibliotheken zum Konvertieren von DOCX-Dateien in PDF in .NET. Das Verständnis der Vor- und Nachteile hilft Ihnen, das richtige Werkzeug für Ihren Anwendungsfall auszuwählen.

Telerik Document Processing (RadWordsProcessing) unterstützt die Konvertierung von DOCX- in PDF-Dateien und ist Bestandteil der Telerik- Suite. Es arbeitet vollständig in verwaltetem Code und benötigt keine nativen Abhängigkeiten, die Darstellungsgenauigkeit bei komplexen Layouts kann jedoch von der von Word abweichen. Aspose.Words ist eine weitere etablierte Option mit hoher Wiedergabetreue und einer umfangreichen API, allerdings fallen ähnliche Lizenzkosten pro Entwickler wie bei IronPDF an.

Als Open-Source-Alternative bietet DocX von Xceed die Möglichkeit zur DOCX-Bearbeitung, jedoch keine direkte PDF-Konvertierung. Entwickler, die unter Linux eine Option ohne Abhängigkeiten benötigen, können auch LibreOffice (headless) aus einem Prozess aufrufen, allerdings führt dies zu einer großen binären Abhängigkeit und einem hohen Aufwand für die Prozesserzeugung.

Der Hauptvorteil von IronPDF in diesem Vergleich ist die Kombination aus hoher Wiedergabetreue, keiner nativen Office-Abhängigkeit, Linux-Unterstützung und einer unkomplizierten NuGet-basierten Installation. Für Teams, die bereits eine IronPDF Lizenz für die HTML-zu-PDF-Konvertierung verwenden, ist der DOCX-Renderer ohne zusätzliche Kosten enthalten.

Was sind Ihre nächsten Schritte?

Sie verfügen nun über eine solide Grundlage für die Konvertierung von Word-Dokumenten in PDF in jeder .NET oder ASP.NET -Anwendung. Hier ist, was Sie als Nächstes erkunden sollten:

• Laden Sie IronPDF herunter und probieren Sie es aus -- Beginnen Sie mit der kostenlosen Testversion , um den vollen Funktionsumfang in Ihrem eigenen Projekt zu testen, bevor Sie sich für eine Lizenz entscheiden.
• Lesen Sie den DOCX-Konvertierungsleitfaden -- Der Artikel "DocxToPdfRenderer – Anleitung" behandelt Sonderfälle, erweiterte Optionen und Leistungsoptimierung ausführlich.
• HTML-zu-PDF-Konvertierung entdecken -- Wenn Ihr Workflow HTML-Vorlagen oder Razor Ansichten umfasst, kann IronPDF HTML mit derselben intuitiven API-Oberfläche in PDF konvertieren .
• Dokumente zusammenführen und aufteilen -- Erfahren Sie, wie Sie mehrere PDFs zu einer einzigen Datei zusammenführen oder eine große PDF-Datei in einzelne Seiten aufteilen.
• Digitale Signaturen hinzufügen -- Für rechtliche oder Compliance-Workflows unterstützt IronPDF digitale PDF-Signaturen mit X.509-Zertifikaten.
• Lizenzierungsoptionen prüfen -- Erkunden Sie die Lizenzierung pro Entwickler, Standort und OEM, um den Plan zu finden, der zu Ihrem Bereitstellungsmodell passt.
• Im Blog stöbern -- Der IronPDF Blog enthält Anleitungen zur PDF-Erstellung, -Bearbeitung, OCR-Integration und mehr.