IronPDF Schnellstartanleitung

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

Installieren Sie IronPDF und erstellen Sie Ihre erste PDF-Datei in nur fünf Minuten. Mit seiner einfachen API können Sie HTML, DOCX, Bilder und vieles mehr in pixelgenaue PDFs konvertieren.

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 IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer
NuGet Paket Manager
DLL-Download

Besuchen Sie die IronPDF NuGet-Bibliothek:

  1. Rechtsklick auf Verweise im Projektmappen-Explorer
  2. Wählen Sie 'NuGet-Pakete verwalten' > 'Durchsuchen' > Suchen Sie IronPdf
Install-Package IronPdf
  • Download IronPDF DLL Paket
  • Entpacken Sie die ZIP-Datei für Ihr Betriebssystem in ein Verzeichnis Ihres Lösung-Verzeichnisses
  • Klicken Sie im Visual Studio Lösung Explorer mit der rechten Maustaste auf "Abhängigkeiten"
  • projektreferenz hinzufügen" > Wählen Sie "Durchsuchen", um alle aus der ZIP-Datei extrahierten DLLs einzuschließen.

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

4. Erstellen Sie Ihr erstes PDF

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

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel
Leere PDF-Datei erstellen
HTML-String in PDF konvertieren
Konvertieren von DOCX in PDF

Die einfachste Art, ein PDF-Objekt zu erstellen, verwendet nur die Breite und Höhe. Dieser PdfDocument-Konstruktor erstellt eine leere PDF-Datei, die dann angepasst werden kann.

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

Mit der Methode ChromePdfRenderer.RenderHtmlAsPdf können Sie mit der eingebetteten Chromium-Engine jedes HTML (einschließlich HTML5) in ein PDF 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

Mit der Klasse DocxToPdfRenderer können Sie Word-Dokumente in PDF-Dateien konvertieren und DOCX-Dateien direkt in anpassbare PDF-Dateien umwandeln, die sich nahtlos in .NET-Anwendungen integrieren lassen.

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

5. Weitere fortschrittliche Beispiele

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

Kopf- und Fußzeilen einfügen
Text umwandeln
PDFs zusammenführen

Erstellen Sie Kopf- oder Fußzeilen, indem Sie TextHeaderFooter instanziieren, Ihren Text hinzufügen und ihn an die PDF-Datei 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

Mit RedactTextOnAllPages können Sie ganz einfach Text redigieren, um einen Satz im gesamten Dokument 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

Fügen Sie zwei PDF-Dateien in C# mit der Methode Merge zusammen. Verwenden Sie ReplaceTextOnAllPages für jedes PdfDocument, ob 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

Schnelle Fehlerbehebung

Ausgabe Lösung
Fehlende Visual C++ Runtime Installieren Sie Visual C++ Redistributable - beide x86- und x64-Versionen sind für die Chrome-Engine erforderlich
Lizenz nicht erkannt Überprüfen Sie mit der IronPdf.License.IsLicensed Eigenschaft. Stellen Sie sicher, dass die Lizenz vor jeder IronPDF-Operation angewendet wird
Langsames erstes Rendern Rufen Sie IronPdf.Installation.Initialize() beim Start auf, um Rendering-Engines vorzuinitialisieren
Linux/Docker-Abhängigkeiten Setzen Sie Installation.LinuxAndDockerDependenciesAutoConfig = true für die automatische Installation von Abhängigkeiten

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,493,056 | Version: 2025.11 gerade veröffentlicht