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.
-
1Install IronPDF with NuGet Package Manager
-
2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");C# -
3Bereitstellen 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
- 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";Imports IronPdf
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;Imports IronPdfDer 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");Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")Mit der ChromePdfRenderer.RenderHtmlAsPdf Methode können Sie jedes HTML (einschließlich HTML5) mithilfe der eingebetteten Chromium-Engine in ein PDF umwandeln.
using IronPdf;
IronPdf.ChromePdfRenderer
.StaticRenderHtmlAsPdf("<p>Hello World</p>")
.SaveAs("string-to-pdf.pdf");Mit der DocxToPdfRenderer Klasse konvertieren Sie Word-Dokumente in PDF und können DOCX-Dateien direkt in anpassbare PDFs rendern, um eine nahtlose Integration in .NET-Apps zu erreichen.
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 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");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")Reduzieren Sie Text ganz einfach mit RedactTextOnAllPages, 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");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 Merge Methode zusammen. Verwenden Sie ReplaceTextOnAllPages auf jedem PdfDocument, neu oder importiert, um alten Text gegen neuen auszutauschen.
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.ConnectTo IronPDFHost 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 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 Handbücher.
