IronPDF Schnellstartanleitung
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
- .NET Framework 4.6.2+ ODER .NET Core 3.1+ ODER .NET 5+
- Visual C++ Redistributable (für Windows).
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.
-
Installieren Sie IronPDF mit NuGet Package Manager
PM > Install-Package IronPdf -
Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf"); -
Bereitstellen zum Testen in Ihrer Live-Umgebung
Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion
Besuchen Sie die IronPDF NuGet-Bibliothek:
- Rechtsklick auf Verweise im Projektmappen-Explorer
- 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"
4. Erstellen Sie Ihr erstes PDF
Fügen Sie dies am Anfang Ihrer .cs Datei hinzu.
using IronPdf;
using IronPdf;
Imports IronPdf
Der einfachste Weg, ein PDF-Objekt zu erstellen, verwendet nur die Breite und Höhe. Dieser PdfDocument-Konstruktor erstellt eine leere PDF-Datei, die zur Anpassung bereit ist.
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")
Mit der Methode ChromePdfRenderer.RenderHtmlAsPdf können Sie beliebigen HTML-Code (einschließlich HTML5) mithilfe der integrierten Chromium-Engine 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");
Imports IronPdf
IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello Word</p>").SaveAs("string-to-pdf.pdf")
Konvertieren Sie WORD-Dokumente mit der DocxToPdfRenderer-Klasse in PDF-Dateien. Damit können Sie DOCX-Dateien direkt in anpassbare PDFs rendern und nahtlos in .NET-Anwendungen integrieren.
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")
5. Weitere fortschrittliche Beispiele
Neben der unkomplizierten Erstellung und Konvertierung von PDFs bietet IronPDF auch leistungsstärkere Anpassungsoptionen für PDFs.
Erstellen Sie Text-Kopf- oder Fußzeilen, indem Sie TextHeaderFooter instanziieren, Ihren Text hinzufügen und diesen 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");
Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)
pdf.SaveAs("addTextHeaderFooter.pdf")
Text kann ganz einfach mit RedactTextOnAllPages redigiert werden, um eine Phrase 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")
Führen Sie zwei PDF-Dateien in C# mit der Methode Merge zusammen. Verwenden Sie ReplaceTextOnAllPages anstelle von PdfDocument, egal 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")
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.

