1. IronPDF
2. Anleitungen
3. Einrichtung

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

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

• Installation über NuGet
• Installation per direktem Download
• Zugriff auf den richtigen Pfad oder Ordner gewähren
• Festlegen des Installationspfads
• Unterstützung für Docker, Linux und mehr

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 DLL-Paket 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:

   • Windows
   • Linux
   • MacOS

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 es vorziehen, den Lizenzschlüssel nicht über Inline-Code anzuwenden, besuchen Sie bitte die Seite 'IronPDF Leitfaden für Lizenzschlüssel' 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, 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 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 beim Starten 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");

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

6. Linux-Kompatibilität

• IronPDF unterstützt Linux. Wir unterstützen offiziell:Ubuntu, Debian, CentOS, Fedora und Amazon Linux 2.
• Einsatz von IronPDF in Linux-Umgebungen ist gut dokumentiert und eine beliebte Wahl für Cloud-Implementierungen wie Azure.

7. Docker-Kompatibilität

• Einsatz von IronPDF auf Docker-Containern ist gut dokumentiert.
• Wir unterstützen offiziell Docker für: Windows, Ubuntu, Debian, CentOS & Amazon Linux 2 und bietenfunktionierende Docker-Dateien für die Bereitstellung.

8. Azure-Kompatibilität

• Offizielle Unterstützung für Azure WebApps, Azure WebJobs, Azure Functions sowie Azure Docker-Instanzen und Azure VMs.
• Lesen Sie das IronPDFAzure & Azure Function Einrichtungsanleitung.

9. Amazon AWS Lambda-Kompatibilität

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

10. macOS-Kompatibilität

• Offizielle Unterstützung für macOS-Bereitstellungen und die Entwicklung mit Rider und "Visual Studio für Mac" werden unterstützt.
• Bitte lesen Sie unserumfassender macOS-Leitfaden.