Wie man mit der IronPDF C# PDF-Bibliothek beginnt
IronPDF ist unsere umfassende und vielseitige Softwarebibliothek, die Ihnen volle granulare Kontrolle über das Erstellen, Bearbeiten und Exportieren von PDF-Dateien in Ihrem Projekt oder Arbeitsablauf gibt. Sowie jeden Aspekt und jedes Detail in seiner Ausgabe.
Mit diesem leistungsstarken Tool, das Unterstützung für eine Vielzahl von Programmiersprachen wie C#, F#, VB.NET, Java und mehr bietet. Es ist die beste Lösung für Ihre PDF-Probleme. Dieser Artikel führt durch die C# IronPDF Installation Methode.
Die kostenlose Software für die Entwicklung ist über NuGet und direkten Download verfügbar. Folgen Sie den nachstehenden Anweisungen, um mit der Konvertierung von HTML in PDF in Ihrem .NET-Projekt zu beginnen.
Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.
Wie man IronPDF installiert: Den richtigen Modus wählen: Native vs Remote
IronPDF bietet zwei Modi zum Rendern von PDFs an -- Native Mode und Remote Mode -- die auf unterschiedliche Entwicklungsumgebungen zugeschnitten sind:
Native Mode: Am besten geeignet für Entwickler, die alles lokal ausführen möchten, geeignet für moderne Windows-, macOS- und Linux-Bereitstellungen. Installieren Sie einfach das folgende Paket:
Remote-Modus (IronPdfEngine): Ideal für cloud- und containerisierte Umgebungen wie Azure, AWS und Docker, in denen Abhängigkeiten zentral verwaltet werden können. Auch ideal für nativ nicht unterstützte oder veraltete Betriebssysteme wie Windows Server 2012 und weniger verbreitete Linux-Distributionen. Installieren Sie einfach das folgende Paket in Ihrem Projekt und verbinden Sie sich mit dem IronPdfEngine-Container:
- IronPdf.Slim
Verwenden Sie IronPDF mit Remote Engine
Bitte beachten Sie
IronPDF hat einige leistungsintensive Funktionen, die Sie möglicherweise remote ausführen möchten. Obwohl IronPDF nicht den IronPdfEngine benötigt, um zu laufen, ist das Einrichten von IronPdfEngine als Remote-Dienst eine optionale Möglichkeit, um plattformspezifische Chrome-Kompatibilitätsprobleme auf älteren Betriebssystemen und mobilen Umgebungen zu vermeiden.
Wie verändert die Verwendung von Engine die Art und Weise, wie ich mit IronPDF programmiere?
Bei der Verwendung der Engine-Konfiguration empfehlen wir, IronPdf.Slim
anstelle des vollständigen IronPdf
-Pakets von NuGet zu installieren, da die Engine den gesamten zusätzlichen Umfang des Native-Pakets verwaltet.
PM> Install-Package IronPdf.Slim
Nachdem Sie IronPdf.Slim
installiert haben, konfigurieren Sie die Verbindungseinstellungen, indem Sie IronPDF auf Ihre IronPdfEngine-Instanz verweisen. Fügen Sie den folgenden Code beim Start Ihrer Anwendung hinzu (oder bevor Sie eine IronPDF-Methode aufrufen):
// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
' Assuming that IronPdfEngine runs
' remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
Wie man die IronPDF-Bibliothek in ein .NET-Projekt (Native) installiert
Die Installation der C# PDF Bibliothek ist einfach und dauert weniger als 5 Minuten.
Die kostenlose Software für die Entwicklung ist über NuGet und als direkter Download erhältlich. Mit diesem Tutorial können Sie Visual Studio in Betrieb nehmen. Folgen Sie den nachstehenden Anweisungen, um mit der Konvertierung von HTML in PDF in Ihrem .NET-Projekt zu beginnen.
Schritt-für-Schritt-Installation der C# PDF-Bibliothek
Anleitung zum Tutorial
Methode 1: Installieren Sie IronPDF über NuGet
Verwenden Sie die folgenden Schritte, um die IronPDF NuGet-Bibliothek innerhalb von Visual Studio zu installieren.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf References, Manage NuGet Packages
Wählen Sie Durchsuchen und suchen Sie nach
IronPdf
- Wählen Sie das Paket aus und installieren Sie es.
Install-Package IronPdf
Es gibt auch IronPDF NuGet-Pakete, die für spezifische Bereitstellungen auf Mac, Linux, Azure, Docker und AWS erhältlich sind, dokumentiert in unserem IronPDF-Advanced-NuGet-Installationshandbuch.
Methode 2: IronPDF durch DLL-Download installieren
Die zweite Möglichkeit, IronPDF zu installieren, ist das Herunterladen des Programms. Befolgen Sie diese schnellen und einfachen Schritte:
Hier sind weitere IronPDF DLL Zip-Pakete für bestimmte Plattformen verfügbar:
Operating System | ZIP Package |
---|---|
Windows | IronPdf.zip |
Linux | IronPdf.Linux.zip |
Mac | IronPdf.MacOs.zip |
- Laden Sie die richtige ZIP-Datei für Ihr Betriebssystem herunter und entpacken Sie sie an einem Speicherort wie ~/Libs in Ihrem Lösungsspeicherverzeichnis.
- Klicken Sie im Visual Studio Solution Explorer mit der rechten Maustaste auf "Abhängigkeiten" und "Projektreferenz hinzufügen". Wählen Sie Durchsuchen und fügen Sie alle aus der ZIP-Datei extrahierten DLLs ein.
Lizenzschlüssel anwenden
Fügen Sie diesen Code beim Starten Ihrer Anwendung ein, bevor Sie IronPDF verwenden. Dieser Ansatz ist universell wirksam und leicht umsetzbar.
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
Wenn Sie den Lizenzschlüssel nicht mit Inline-Code anwenden möchten, besuchen Sie bitte den Artikel 'IronPDF License Keys', um alternative Methoden zu erkunden.
2. Erforderlichen Zugriff auf Datei oder Ordner gewähren
Manchmal kann es erforderlich sein, bestimmten Benutzern oder Rollen auf Ihrem PC Berechtigungen zu erteilen.
Zum Beispiel benötigt jede AppDomain ihren eigenen TempFolderPath und Anwendungen im selben AppPool können keinen TempFolderPath teilen.
Was bedeutet das nun?
Eine AppDomain bietet lediglich eine Isolationsebene innerhalb eines bestimmten Prozesses. Alles, was Sie als "pro Programm" bezeichnen, ist in Wirklichkeit "pro AppDomain". Jede dieser Anwendungen im gleichen Anwendungspool benötigt ihren eigenen temporären Ordner, um völlig unabhängig zu funktionieren.
Falls für eine der oben genannten Optionen zur Fehlerbehebung erforderlich, können Sie die Berechtigungen wie folgt festlegen:
Rechtsklick auf eine Datei oder einen Ordner
Eigenschaften auswählen
Sicherheit wählen
Klicken Sie auf Bearbeiten...
Wählen Sie die gewünschten Berechtigungen aus.
3. Installationspfad festlegen
Um HTML als PDF zu rendern, muss IronPDF Chromium einbetten, das ein sicherer Webbrowser ist. Glücklicherweise ist dieser Prozess vollständig automatisiert.
Wenn IronPDF's HTML to PDF eine "failed rendering"-Ausnahme auslöst, was sehr unwahrscheinlich ist, müssen Sie möglicherweise die nativen Browser-Binärdateien an einen geeigneten Ort entpacken. Der Ordner Temp ist normalerweise ideal.
Hinweis: Programme sind niemals ein geeigneter Speicherort.
Einstellung IronPdf.Installation.TempFolderPath
Sie können den richtigen Speicherort durch Festlegen der TempFolderPath-Eigenschaft des IronPdf.Installation-Objekts wie hier gezeigt entpacken:
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
Denken Sie daran, nach der Aktualisierung eines Pfads alle Temp- und Cache-Ordner auf Ihren Entwicklungs- und Servern zu löschen. Stellen Sie eine CLEAN-Version Ihrer Anwendung erneut bereit.
Einstellen der Umgebungsvariablen für den Temp-Ordner im Anwendungsbereich
IronPDF kann gelegentlich beim Rendern und Bearbeiten von PDF-Dokumenten temporäre Dateien in einem System-Temp-Ordner erzeugen. Wir können IronPDF.Installation.TempFolderPath einstellen, um dies zu umgehen, aber das TempPath-Verzeichnis der Umgebung kann trotzdem manchmal von Drittanbieter-Paketen verwendet werden.
Um dieses Problem zu lösen, können wir die TempPath-Umgebungsvariable anwendungsspezifisch beim Start der C#-Anwendung festlegen. Dies stellt sicher, dass alle von Ihrer Anwendung erstellten temporären Dateien an einem kontrollierbaren Speicherort abgelegt werden.
using IronPdf;
// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);
// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");
// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;
// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);
// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");
// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
Imports IronPdf
' Set Application scope Temp Files Path.
' This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
Private MyTempPath = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)
' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")
' Your PDF Generation and editing code here..E.G.
Dim Renderer = New IronPdf.ChromePdfRenderer()
Dim Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
Doc.SaveAs("example.pdf")
4. Berechtigungen und IIS
Für den Fall, dass der Server gesperrt wurde, müssen Sie dem IIS-Benutzer (IUSER) möglicherweise Lese- und Schreibberechtigungen für Ihren Installationspfad-Ordner sowie für Ihren Windows- und Temp-Ordner geben.
5. Microsoft Visual C++ und Windows-Kompatibilität
IronPDF erfordert die Installation von Microsoft Visual C++ auf dem Windows-Zielrechner. Falls erforderlich, kann es mit einem Anwendungsinstallationsprogramm wie MSI gepackt werden.
Microsoft Visual C++ ist eine Windows-Komponente und ist normalerweise auf modernen Windows-Versionen vorhanden, es sei denn, sie wurden absichtlich heruntergestuft.
Das .NET Framework kann als 32-Bit ausgeführt werden (auch auf 64-Bit-Plattformen), daher ist es notwendig, Visual C++ sowohl in der 32- als auch in der 64-Bit-Version zu installieren.
Hier können Sie Microsoft Visual C++ herunterladen.
6. Linux-Kompatibilität
- IronPDF unterstützt Linux. Wir unterstützen offiziell: Ubuntu, Debian, CentOS, Fedora & Amazon Linux 2.
- Bereitstellung von IronPDF auf Linux ist gut dokumentiert und eine beliebte Wahl für Cloud-Einsätze wie Azure.
7. Docker-Kompatibilität
- Die Bereitstellung von IronPDF auf Docker ist gut dokumentiert.
- Wir unterstützen offiziell Docker für: Windows, Ubuntu, Debian, CentOS & Amazon Linux 2 und stellen funktionierende Docker-Dateien bereit.
8. Azure-Kompatibilität
- Offizielle Unterstützung für Azure WebApps, Azure WebJobs, Azure Functions und Azure Docker-Instanzen und Azure VMs.
- Lesen Sie den IronPDF Azure & Azure Function Setup Guide.
9. Amazon AWS Lambda-Kompatibilität
- Ein Tutorial und Unterstützung für Amazon AWS Lambda sind enthalten.
10. macOS-Kompatibilität
- Offizielle Unterstützung für Bereitstellungen und Entwicklung auf macOS mit Rider und "Visual Studio für Mac" werden unterstützt
- Bitte lesen Sie unseren umfassenden macOS-Leitfaden.