1. IronPDF
  2. Anleitungen
  3. Einrichtung

So installieren Sie die IronPDF-Bibliothek in einem .NET-Projekt

Chaknith Bin
Chaknith Bin
25. Januar 2023
Aktualisiert 20. Oktober 2024
Teilen Sie:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Die Installation der C# PDF-Bibliothek dauert weniger als 5 Minuten.

Die kostenlose Entwicklungssoftware ist über NuGet und als direkter Download erhältlich. Mit diesem Tutorial bringen wir Sie dazu, in Visual Studio loszulegen. 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

Pdf In Csharp No Button related to So installieren Sie die IronPDF-Bibliothek in einem .NET-Projekt

Anleitung zum Tutorial

1.1. Installieren Sie IronPDF über NuGet

Verwenden Sie die folgenden Schritte, um die IronPDF NuGet-Bibliothek innerhalb von Visual Studio zu installieren.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf References, Manage NuGet Packages

  2. Wählen Sie Durchsuchen und suchen Sie nach "IronPdf"

  3. Wählen Sie das Paket aus und installieren Sie es.
Install-Package IronPdf

Es sind auch IronPDF NuGet-Pakete für spezifische Bereitstellungen auf IronPDF Advanced NuGet-Installationsleitfaden dokumentiert sind.

1.2. IronPDF per DLL-Download installieren

Die zweite Möglichkeit, IronPDF zu installieren, ist das Herunterladen des Programms. Befolgen Sie diese schnellen und einfachen Schritte:

  1. Laden Sie das Windows-IronPDF-DLL-Paket herunter und entzippen Sie es an einen Ort wie ~/Libs innerhalb Ihres Lösungsverzeichnisses.

  2. 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.

    Hier sind weitere IronPDF DLL Zip-Pakete für bestimmte Plattformen verfügbar:

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"
$vbLabelText   $csharpLabel

Wenn Sie den Lizenzschlüssel bevorzugt nicht mithilfe von Inline-Code anwenden möchten, besuchen Sie bitte den 'IronPDF License Keys Guide', 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 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:

  1. Rechtsklick auf eine Datei oder einen Ordner

  2. Eigenschaften auswählen

  3. Sicherheit wählen

  4. Klicken Sie auf Bearbeiten..

  5. 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 nach der Aktualisierung eines Pfades daran, 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-Umgebungsverzeichnis kann trotzdem manchmal von Drittanbieter-Paketen verwendet werden.

Um dieses Problem zu lösen, können wir die TempPath-Umgebungsvariable in der gesamten C#-Anwendungsstart einstellen. Dies stellt sicher, dass alle temporären Dateien, die von Ihrer Anwendung erstellt werden, an einem kontrollierbaren Ort gespeichert 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")
$vbLabelText   $csharpLabel

4. Berechtigungen und IIS

Falls der Server gesperrt wurde, müssen Sie dem IIS-Benutzer (IUSER) Lese- und Schreibberechtigungen für Ihren Installationspfad-Ordner sowie für Ihre Windows- und Temp-Ordner erteilen.

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 (z. B. MSI) gepackt werden.

Microsoft Visual C++ ist eine Windows-Komponente und normalerweise in modernen Windows-Versionen enthalten, es sei denn, sie wurden absichtlich heruntergeschraubt.

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++ von der offiziellen Support-Seite herunterladen.

6. Linux-Kompatibilität

7. Docker-Kompatibilität

8. Azure-Kompatibilität

  • Offizielle Unterstützung für Azure WebApps, Azure WebJobs, Azure Functions sowie Azure Docker-Instanzen und Azure VMs.
  • Lesen Sie den IronPDF Azure & Azure Function Setup Guide.

9. Amazon AWS Lambda-Kompatibilität

10. macOS-Kompatibilität

Chaknith Bin
Chaknith Bin
  Jetzt mit dem Ingenieurteam chatten
Software-Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat tiefgehende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Erkenntnisse aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentation und einem insgesamt besseren Erlebnis bei.