IronPDF Quickstart Guide

This article was translated from English: Does it need improvement?
Translated
View the article in English

Installieren Sie IronPDF und erstellen Sie Ihr erstes PDF in nur fünf Minuten. Mit seiner einfachen API können Sie HTML, DOCX, Bilder und mehr in makellose PDFs umwandeln.

1. Voraussetzungen


2. Installation von IronPDF

Standardinstallation von IronPDF läuft lokal. Wenn Sie auf Docker/Microservices bereitstellen möchten, schauen Sie sich die Remote Engine Mode Guide an.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
data-active-tab="1">
class="installation-options__tabs">
data-tab="1"> NuGet-Paket-Manager
data-tab="2"> DLL-Download
data-tab="1">
data-tab="2">
id="nuget-package-manager-start">

Gehen Sie zur IronPDF NuGet-Bibliothek:

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise
  2. Wählen Sie 'NuGet-Pakete verwalten' > 'Durchsuchen' > Suchen Sie IronPdf
Install-Package IronPdf
id="nuget-package-manager-end">
id="dll-download-start">
  • Laden Sie das IronPDF DLL-Paket herunter
  • Entpacken Sie die ZIP-Datei für Ihr Betriebssystem in einem Verzeichnis innerhalb Ihres Lösungsverzeichnisses
  • Klicken Sie im Visual Studio-Explorfer mit der rechten Maustaste auf 'Dependencies'
  • 'Projektverweis hinzufügen' > Wählen Sie 'Durchsuchen' und fügen Sie alle aus dem Zip extrahierten DLLs hinzu.

class="related-link">VERWANDT: Mehr über Konfigurationseinstellungen

id="dll-download-end">

Plattform-spezifische Leitfäden


3. Lizenzschlüssel anwenden

Beim Kauf von IronPDF-Lizenzen oder wenn Sie sich entscheiden, mit einer 30-tägigen Testversion zu beginnen, wird Ihnen ein Lizenzschlüssel an Ihre E-Mail gesendet. Kopieren Sie den Schlüssel und fügen Sie ihn am Anfang Ihrer App ein.

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
$vbLabelText   $csharpLabel

class="related-link">Siehe IronPDF-Lizenzierung


4. Erstellen Sie Ihr erstes PDF

class="related-link">IronPDF hilft Ihnen, PDFs zu erstellen oder HTML, DOCX, RTF, Markdown und Bilder mit vollständiger Treue in PDF umzuwandeln. Erfahren Sie mehr über verschiedene Arten der PDF-Konvertierung

Fügen Sie dies am Anfang Ihrer .cs Datei hinzu.

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel
data-active-tab="1">
class="installation-options__tabs">
data-tab="1"> Ein leeres PDF erstellen
data-tab="2"> HTML-String in PDF umwandeln
data-tab="3"> DOCX in PDF umwandeln
data-tab="1">
data-tab="2">
data-tab="3">
id="create-a-blank-pdf-start">

Der einfachste Weg, ein PDF-Objekt zu erstellen, verwendet nur die Breite und Höhe. Dieser PdfDocument-Konstruktor erstellt ein leeres PDF, bereit zur Anpassung.

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
id="create-a-blank-pdf-end">
id="convert-html-string-to-pdf-start">

Mit der Methode ChromePdfRenderer.RenderHtmlAsPdf können Sie HTML (einschließlich HTML5) in ein PDF mit der eingebetteten Chromium-Engine umwandeln.

using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");
using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

class="related-link">VERWANDTER ANLEITUNGSARTIKEL: Wie man HTML-String in PDF in C# umwandelt

id="convert-html-string-to-pdf-end">
id="convert-docx-to-pdf-start">

Konvertieren Sie Word-Dokumente in PDFs mit der DocxToPdfRenderer Klasse. Sie können DOCX-Dateien direkt in anpassbare PDFs rendern, um eine nahtlose Integration in .NET-Anwendungen zu ermöglichen.

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
Imports IronPdf

Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")
$vbLabelText   $csharpLabel

class="related-link">VERWANDTER ANLEITUNGSARTIKEL: Wie man Microsoft Word in PDF in C# umwandelt

id="convert-docx-to-pdf-end">

5. Weitere fortschrittliche Beispiele

Neben der unkomplizierten Erstellung und Konvertierung von PDFs bietet IronPDF auch leistungsstärkere Anpassungsoptionen für PDFs.

data-active-tab="1">
class="installation-options__tabs">
data-tab="1"> Kopf- und Fußzeilen hinzufügen
data-tab="2"> Text schwärzen
data-tab="3"> PDFs zusammenführen
data-tab="1">
data-tab="2">
data-tab="3">
id="add-headers-and-footers-start">

Erstellen Sie Textkopf- oder Fußzeilen, indem Sie TextHeaderFooter instanziieren, Ihren Text hinzufügen und ihn an das PDF anhängen.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

class="related-link">VERWANDTER ANLEITUNGSARTIKEL: Wie man Kopf- und Fußzeilen hinzufügt

id="add-headers-and-footers-end">
id="redact-text-start">

Schwärzen Sie Text mühelos, indem Sie RedactTextOnAllPages verwenden, um einen gesamten Dokumentabschnitt zu entfernen.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")

' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")

pdf.SaveAs("redacted.pdf")
$vbLabelText   $csharpLabel

class="related-link">VERWANDTER ANLEITUNGSARTIKEL: Wie man URL in PDF rendert

id="redact-text-end">
id="merge-pdfs-start">

Führen Sie zwei PDF-Dateien in C# mit der Merge-Methode zusammen. Verwenden Sie ReplaceTextOnAllPages auf jedem PdfDocument, neu oder importiert, um alten Text durch neuen zu ersetzen.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

pdf.SaveAs("replaceText.pdf")
$vbLabelText   $csharpLabel

class="related-link">VERWANDTER ANLEITUNGSARTIKEL: Wie man PDFs zusammenführt oder teilt

id="merge-pdfs-end">

Schnelle Fehlerbehebung

class="quick-troubleshooting">
Problem Lösung
Visual C++-Laufzeit fehlt Installieren Sie das Visual C++ Redistributable - sowohl x86- als auch x64-Versionen sind für die Chrome-Engine erforderlich
Lizenz wird nicht erkannt Überprüfen Sie mit der Eigenschaft IronPdf.License.IsLicensed. Stellen Sie sicher, dass die Lizenz angewendet wird, bevor IronPDF-Operationen ausgeführt werden
Langsame erste Anzeige Rufen Sie IronPdf.Installation.Initialize() beim Start auf, um die Rendering-Engines vorzuinitialisieren
Linux/Docker-Abhängigkeiten Setzen Sie Installation.LinuxAndDockerDependenciesAutoConfig = true für die automatische Abhängigkeitsinstallation

Nächste Schritte


Häufig gestellte Fragen

Wie kann ich IronPdfEngine für die entfernte PDF-Erstellung einrichten?

Um IronPdfEngine für die entfernte PDF-Erstellung einzurichten, installieren Sie das IronPdf.Slim-Paket von NuGet und konfigurieren Sie die Verbindungseinstellungen mit der IronPdfConnectionConfiguration-Klasse. Diese Einrichtung ermöglicht es Ihnen, Ihre Anwendung mit der IronPdfEngine-Instanz remote zu verbinden.

Was sind die Hauptvorteile der Verwendung von IronPdfEngine mit meiner Anwendung?

Die Verwendung von IronPdfEngine mit Ihrer Anwendung ermöglicht die Remote-Ausführung von PDF-Aufgaben, was hilft, plattformspezifische Kompatibilitätsprobleme zu vermeiden, insbesondere auf älteren Systemen und mobilen Plattformen. Es eliminiert auch die Notwendigkeit der .NET-Laufzeit während der Ausführung.

Warum könnte ich mich entscheiden, IronPdfEngine anstelle der nativen PDF-Bibliothek zu verwenden?

Sie könnten sich für IronPdfEngine entscheiden, um leistungsintensive PDF-Funktionen remote auszuführen, die Kompatibilitätsprobleme mit verschiedenen Betriebssystemen zu reduzieren und die Leistung zu verbessern, indem ein Chrome-identischer Renderer für die Umwandlung von HTML in PDF genutzt wird.

Wird horizontale Skalierung in IronPdfEngine unterstützt?

Nein, IronPdfEngine unterstützt derzeit keine horizontale Skalierung, was bedeutet, dass es nicht über mehrere Instanzen hinweg geladen werden kann, da PDF-Datei-Binärdaten im Serverspeicher gehandhabt werden.

Kann IronPdfEngine unter verschiedenen Betriebssystemen ausgeführt werden?

IronPdfEngine ist darauf ausgelegt, auf Linux-Systemen mithilfe von Docker-Containern zu laufen. Die Binärdateien sind jedoch plattformabhängig, daher müssen Sie sicherstellen, dass Sie die richtige Version für Ihr Betriebssystem verwenden.

Was sollte ich tun, wenn meine PDF-Ausgaben unterschiedlich sind, wenn ich IronPdfEngine verwende?

PDF-Ausgaben können aufgrund unterschiedlicher Betriebssystemverhalten leicht variieren. Um Unterschiede zu minimieren, stellen Sie sicher, dass Sie das richtige Docker-Image verwenden und überprüfen Sie eventuell bestehende, betriebssystemspezifische Einstellungen, die das Rendering beeinflussen könnten.

Wie stelle ich sicher, dass meine Anwendung die richtige Version von IronPdfEngine verwendet?

Um Kompatibilität sicherzustellen, erfordert jede Version von IronPDF eine passende Version von IronPdfEngine. Stellen Sie sicher, dass Sie beide Komponenten gleichzeitig aktualisieren, um Probleme zwischen den Versionen zu vermeiden.

Welche Einschränkungen gibt es bei der Verwendung von IronPdfEngine auf Windows?

Bei der Verwendung von IronPdfEngine auf Windows benötigen Sie Linux-Container für Docker und müssen sicherstellen, dass der Serverport erreichbar ist. Die Binärdateien sind plattformspezifisch und der Wechsel zu Linux-Containern ist erforderlich.

Wie konfiguriere ich IronPDF für die Verbindung zu einem entfernten IronPdfEngine-Server?

Um IronPDF für einen entfernten Server zu konfigurieren, verwenden Sie Installation.ConnectToIronPdfHost mit der Methode IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer und spezifizieren Sie die IP- und Port-Details des Servers.

Welches Paket sollte ich verwenden, um die Anwendungsgröße bei Verwendung von IronPdfEngine zu minimieren?

Sie sollten das IronPdf.Slim-Paket von NuGet verwenden, da es nur die notwendigen Komponenten für den Betrieb von IronPDF mit IronPdfEngine enthält und so die Anwendungsgröße reduziert.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 16,133,208 | Version: 2025.11 gerade veröffentlicht