Erste Schritte mit der IronPDF C# PDF-Bibliothek

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:

Wie man IronPDF installiert: Den richtigen Modus wählen: Native vs Remote

IronPDF bietet zwei Modi für die Erstellung von PDFs an — Native Mode und Remote Mode — zugeschnitten auf verschiedene Entwicklungsumgebungen:

Native Mode: Am besten geeignet für Entwickler, die alles lokal ausführen möchten, geeignet für moderne Windows-, macOS- und Linux-Deployments. Einfach installieren Sie das IronPDF Paket in Ihr .NET-Projekt einbinden.
Remote-Modus(IronPdfEngine): Ideal für Cloud- und containerisierte Umgebungen wie Azure, AWS und Docker, wo Abhängigkeiten zentral verwaltet werden können. Auch ideal für nicht-nativ unterstützte oder ältere Betriebssysteme wie Windows Server 2012 und weniger bekannte Linux-Distributionen. Einfach installieren Sie das IronPdf.Slim in Ihr .NET-Projekt ein und hosten Sie das IronPdfEngine in einem Container.

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 ändert die Nutzung 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

Nach der Installation von IronPdf.Slim 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 eine IronPDF-Methode aufgerufen wird):

// 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"))

VB C#

Wie man die IronPDF-Bibliothek in ein .NET-Projekt (Einheimisch) installiert

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

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

Methode 1: Installieren Sie IronPDF über NuGet

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

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 für spezifische Implementierungen fürMac, Linux, Azurblau, Docker und AWS, dokumentiert in unseremIronPDF erweiterte NuGet-Installationsanleitung.

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:

Windows -Laden Sie IronPdf.zip herunter
Linux - Download IronPdf.Linux.zip
Mac - Download 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"

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:

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

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");

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")

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

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

7. Docker-Kompatibilität

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

8. Azure-Kompatibilität

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