Wie man mit der IronPDF C# PDF-Bibliothek beginnt

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

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.

Erster Schritt:
green arrow pointer

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:

  • IronPdf

    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
Was ist der Unterschied zwischen Native & Engine?

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

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.


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.

  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 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 SystemZIP Package
WindowsIronPdf.zip
LinuxIronPdf.Linux.zip
MacIronPdf.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"
$vbLabelText   $csharpLabel

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:

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

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

7. Docker-Kompatibilität

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

10. macOS-Kompatibilität