1. IronPDF
  2. Anleitungen
  3. Einrichtung

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

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

Installation derC# PDF-Bibliothek 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

1.1. Installieren Sie IronPDF über NuGet

Mit den nächsten Schritten installieren Sie dieIronPDF NuGet-Bibliothek von Visual Studio aus.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf References, Manage NuGet Packages
  2. Wählen Sie Durchsuchen und suchen Sie "IronPDF"
  3. Wählen Sie das Paket aus und installieren Sie es.
Install-Package IronPdf

Es gibt auch IronPDF NuGet-Pakete für spezifische Implementierungen fürMac, Linux, Azurblau, Docker und AWS, dokumentiert in unseremIronPDF erweiterte NuGet-Installationsanleitung.

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. Herunterladen und Entpacken der WindowsIronPDF-Datei an einem Ort wie ~/Libs innerhalb Ihres Solution-Verzeichnisses

  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"
VB   C#

Wenn Sie es vorziehen, den Lizenzschlüssel nicht über Inline-Code anzuwenden, besuchen Sie bitte die Seite 'IronPDF Lizenz-Schlüsselartikel, um alternative Methoden zu untersuchen.

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, jederAppDomain erfordert eine eigeneTempFolderPath und Anwendungen in der gleichenAppPool können einen TempFolderPath nicht gemeinsam nutzen.

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

WiedergebenHTML als PDFironPDF muss Chromium einbetten, einen sicheren Webbrowser. 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 an den richtigen Ort entpacken, indem Sie die Eigenschaft TempFolderPath der DateiIronPDF.Installation objekt wie hier gezeigt:

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 beim Start der C#-Anwendung anwendungsweit festlegen. Dadurch wird sichergestellt, 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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

4. Berechtigungen und IIS

Für den Fall, dass der Server gesperrt wurde, müssen Sie dem IIS-Benutzer(IUSER) lese- und Schreibrechte für Ihren Installationspfad-Ordner sowie für Ihren Windows- und Temp-Ordner.

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-Version 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 Siemicrosoft Visual C++ herunterladen.

6. Linux-Kompatibilität

7. Docker-Kompatibilität

8. Azure-Kompatibilität

9. Amazon AWS Lambda-Kompatibilität

Atutorium und Unterstützung für Amazon AWS Lambda ist enthalten.

10. macOS-Kompatibilität