using IronPdf;
// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
// Export to a file or Stream
pdf.SaveAs("output.pdf");
// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");
In modernen Webanwendungen ist die Generierung von Dokumenten aus HTML-Inhalten eine gängige Anforderung. Ob Sie Rechnungen, Berichte oder andere Arten von Dokumenten erstellen müssen, die Konvertierung von HTML in PDF kann mit der IronPDF-Bibliothek in ASP.NET unter Verwendung von C# effizient durchgeführt werden.
Heute werden wir uns ansehen, wie IronPDF eingerichtet und zur Konvertierung von HTML-Inhalten in ein PDF-Dokument verwendet wird.
Konvertieren von HTML in PDF in ASP.NET mit IronPDF
Erstellen Sie ein ASP.NET-Projekt mit Visual Studio oder einer IDE Ihrer Wahl.
Installieren Sie IronPDF und richten Sie Ihren Lizenzschlüssel ein.
Erstellen Sie einen neuen Controller oder eine Seite, auf der Sie die PDF-Konvertierung durchführen möchten.
Schreiben Sie Ihre Konvertierungslogik innerhalb des Controllers.
Konfigurieren Sie das Routing, um den Zugriff auf Ihre PDF-Generierungsaktion zu ermöglichen.
Ein Überblick über IronPDF
IronPDF ist eine leistungsstarke PDF-Bibliothek, die es Entwicklern ermöglicht, PDF-Dokumente zu lesen, zu erstellen und zu manipulieren. Mit einem umfangreichen Funktionsumfang und einem schnellen, einfachen Installationsprozess können Sie Ihre PDF-Projekte dank IronPDF im Handumdrehen auf die nächste Stufe heben. Die intuitive und leicht zu erlernende API ist die ideale Wahl, wenn Sie direkt aus Ihrer Webanwendung heraus dynamische PDF-Dokumente erzeugen, PDF-Sicherheitsaufgaben durchführen, PDF-Anmerkungen anbringen usw. möchten.
Eigenschaften
PDF-Konvertierung: IronPDF kann HTML-Dateien in PDF konvertieren. Mit voller Unterstützung für moderne Webstandards können Sie sicher sein, dass IronPDF konstant pixelgenaue PDFs aus Ihren HTML-Seiten zurückgibt. IronPDF kann auch PDF-Dateien aus anderen Formaten wie DOCX, Bilder, RTF und mehr konvertieren.
PDF-Erstellung: Mit IronPDF können Sie PDFs aus jeder Webseite, ASPX-Datei, HTML-Zeichenfolge und mehr erstellen.
Sicherheitsfunktionen: Mit IronPDF können Sie stets sicher sein, dass alle sensiblen PDF-Dateien dank seiner Sicherheitsfunktionen geschützt sind. Verwenden Sie IronPDF, um Ihre PDF-Dateien zu verschlüsseln, Passwörter festzulegen und Berechtigungen für Ihre PDF-Dateien zu vergeben.
PDF-Bearbeitungsfunktionen: Mit IronPDF können Sie vorhandene PDF-Dokumente bearbeiten, ändern und PDF-Dateien mühelos lesen. IronPDF bietet Bearbeitungsfunktionen wie das Hinzufügen von Kopf- und Fußzeilen, das Stempeln von Text und Bildern auf den PDF-Seiten, das Hinzufügen von benutzerdefinierten Wasserzeichen zum PDF, die Arbeit mit PDF-Formularen und das Teilen oder Zusammenführen von PDF-Dateien.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie über:
Visual Studio oder eine andere C#-Entwicklungsumgebung einrichten.
IronPDF-Bibliothek installiert. Sie können es von NuGet oder direkt von der IronPDF-Website beziehen.
Ein neues ASP.NET-Projekt erstellen
Starten Sie Visual Studio und wählen Sie den ASP.NET-Projekttyp, der Ihren Anforderungen am besten entspricht. Für das heutige Beispiel werde ich eine ASP.NET Core-Webanwendung (Model-View-Controller) erstellen.
Geben Sie dann den Namen für Ihr Projekt ein und wählen Sie den Ort, an dem das Projekt untergebracht werden soll.
Wählen Sie schließlich Ihr .NET Framework für das Projekt aus und ändern Sie alle zusätzlichen Einstellungen für das Projekt, wie z. B. den Authentifizierungstyp oder die Aktivierung von Container-Unterstützung und Docker.
Erstellen Sie einen Controller
Um einen neuen Controller zu erstellen, in dem unser HTML-zu-PDF-Code untergebracht wird, klicken Sie zunächst mit der rechten Maustaste auf den Ordner "Controllers" im Projektmappen-Explorer und wählen Sie "Hinzufügen -> Controller".
Daraufhin wird ein neues Fenster geöffnet, in dem Sie auswählen können, welche Form von Controller Sie dem Projekt hinzufügen möchten. Wir haben einen leeren MVC-Controller ausgewählt.
Schließlich geben wir dem neuen Controller einen Namen und klicken auf "Hinzufügen", um ihn zu unserem Projekt hinzuzufügen.
Code für die Konvertierung von HTML in PDF hinzufügen
Nachdem wir nun unser ASP.NET-Projekt erstellt haben, können wir mit dem Schreiben des Codes für die Konvertierung von HTML-Dateiinhalten in eine PDF-Datei beginnen. Wir beginnen mit einem einfachen Beispiel für die Umwandlung eines HTML-Strings in eine PDF-Datei, bevor wir uns die Konvertierung von HTML-Inhalten mit Anpassungen ansehen.
using IronPdf;
using Microsoft.AspNetCore.Mvc;
namespace IronPdfTest.Controllers
{
public class PdfController : Controller
{
public IActionResult GeneratePdf()
{
// String of HTML code to be converted to PDF
string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Convert HTML string to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
}
}
}
using IronPdf;
using Microsoft.AspNetCore.Mvc;
namespace IronPdfTest.Controllers
{
public class PdfController : Controller
{
public IActionResult GeneratePdf()
{
// String of HTML code to be converted to PDF
string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Convert HTML string to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
}
}
}
Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Namespace IronPdfTest.Controllers
Public Class PdfController
Inherits Controller
Public Function GeneratePdf() As IActionResult
' String of HTML code to be converted to PDF
Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"
Dim renderer As New ChromePdfRenderer()
' Convert HTML string to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
End Function
End Class
End Namespace
$vbLabelText $csharpLabel
ASP.NET MVC verwendet Controller, um Benutzeranfragen zu bearbeiten. Wenn ein Benutzer zu einer bestimmten URL navigiert, ruft ASP.NET eine Methode in dem mit dieser Route verbundenen Controller auf.
PdfController ist eine Klasse, die von Controller erbt, was bedeutet, dass sie Webanfragen bearbeiten und Antworten senden kann.
Die GeneratePdf-Methode in diesem Controller wird eine Anfrage zur Umwandlung von HTML in eine PDF-Datei bearbeiten und das Ergebnis zurückgeben.
Wenn ein Benutzer eine URL aufruft, die mit der GeneratePdf-Aktion verknüpft ist, wird die Methode ausgeführt.
IActionResult: Dies ist der Rückgabewert, der die Antwort darstellt, die die Webanwendung an den Benutzer zurücksenden wird. Es könnte ein View (HTML-Seite), ein Dateidownload usw. sein. In diesem Fall ist es eine PDF-Datei.
GeneratePdf()-Methode:
Innerhalb der Methode definieren wir einen String htmlContent, der das HTML enthält, das Sie in eine PDF-Datei konvertieren möchten.
Hello, IronPDF!
Dies ist eine von HTML generierte PDF.
Wir erstellen eine neue Instanz von ChromePdfRenderer, die die Umwandlung von HTML in PDF übernimmt.
Die Methode RenderHtmlAsPdf() nimmt den HTML-String und gibt ein PDF-Objekt zurück.
Routing konfigurieren
In einer ASP.NET MVC-Anwendung definieren Sie Routen, die URLs auf Controllermethoden (Aktionen) abbilden. Zum Beispiel, wenn Sie im Browser zu /Pdf/GeneratePdf navigieren, wird ASP.NET nach dem PdfController suchen und dessen GeneratePdf-Methode aufrufen. Stellen Sie sicher, dass Ihre Routing-Konfiguration den Zugriff auf die GeneratePdf-Aktion erlaubt. Wenn Sie ASP.NET Core MVC verwenden, wird dies normalerweise automatisch konfiguriert. Wenn Sie Web-API verwenden, stellen Sie sicher, dass Ihre Routen richtig eingerichtet sind.
Benutzerdefinierte PDF-Ausgabe
Nachdem wir nun die Grundlagen kennen, wollen wir uns die Erstellung einer PDF-Datei aus HTML-Inhalten mit einigen Anpassungseinstellungen für die PDF-Ausgabe ansehen. IronPDF bietet eine leistungsstarke Reihe von PDF-Anpassungswerkzeugen, wie z.B. Ränder, Kopf- und Fußzeilen, benutzerdefinierte PDF-Größen und mehr.
using IronPdf;
using Microsoft.AspNetCore.Mvc;
namespace IronPdfTest.Controllers
{
// Controller for our PDF converter
public class PdfController : Controller
{
public IActionResult GeneratePdf()
{
string url= "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Creating the cover page
PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");
// Adding custom options for our final PDF
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
renderer.RenderingOptions.TextHeader.FontSize = 12;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.FirstPageNumber = 2;
// Creating our main PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(url);
// Appending the cover to the main PDF
pdf.InsertPdf(cover, 0);
return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
}
}
}
using IronPdf;
using Microsoft.AspNetCore.Mvc;
namespace IronPdfTest.Controllers
{
// Controller for our PDF converter
public class PdfController : Controller
{
public IActionResult GeneratePdf()
{
string url= "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Creating the cover page
PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");
// Adding custom options for our final PDF
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
renderer.RenderingOptions.TextHeader.FontSize = 12;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.FirstPageNumber = 2;
// Creating our main PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(url);
// Appending the cover to the main PDF
pdf.InsertPdf(cover, 0);
return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
}
}
}
Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Namespace IronPdfTest.Controllers
' Controller for our PDF converter
Public Class PdfController
Inherits Controller
Public Function GeneratePdf() As IActionResult
Dim url As String= "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"
Dim renderer As New ChromePdfRenderer()
' Creating the cover page
Dim cover As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>")
' Adding custom options for our final PDF
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3
renderer.RenderingOptions.TextHeader.CenterText = "IronPDF"
renderer.RenderingOptions.TextHeader.FontSize = 12
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.FirstPageNumber = 2
' Creating our main PDF
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(url)
' Appending the cover to the main PDF
pdf.InsertPdf(cover, 0)
Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
End Function
End Class
End Namespace
$vbLabelText $csharpLabel
Schlussfolgerung
Heute haben wir einen genaueren Blick darauf geworfen, wie die Konvertierung von HTML in PDF mit ASP.NET verwendet werden kann, und haben den Prozess der Erstellung von PDF-Dateien aus HTML innerhalb eines ASP.NET-Projekts untersucht. Wenn Sie die oben beschriebenen Schritte befolgen, können Sie die PDF-Generierung problemlos in Ihre Webanwendungen integrieren und so aus HTML-Inhalten hochwertige, druckbare Dokumente erstellen.
IronPDF bietet eine Vielzahl von Funktionen, die genutzt werden können, um hochwertige PDF-Dokumente zu erstellen. Für fortgeschrittenere Funktionen und detaillierte Anpassungen lesen Sie die IronPDF Dokumentation. Mit der schnellen Installation können Sie IronPDF in kürzester Zeit in Ihrem Projekt einrichten.
Chipego hat eine natürliche Fähigkeit zum Zuhören, die ihm hilft, Kundenprobleme zu verstehen und intelligente Lösungen anzubieten. Er trat dem Iron Software-Team 2023 bei, nachdem er einen Bachelor of Science in Informationstechnologie erworben hatte. IronPDF und IronOCR sind die beiden Produkte, auf die sich Chipego konzentriert hat, aber sein Wissen über alle Produkte wächst täglich, da er neue Wege findet, Kunden zu unterstützen. Er genießt die Zusammenarbeit bei Iron Software, da Teammitglieder aus dem gesamten Unternehmen ihre unterschiedlichen Erfahrungen einbringen und so zu effektiven, innovativen Lösungen beitragen. Wenn Chipego nicht an seinem Schreibtisch sitzt, kann man ihn oft bei einem guten Buch oder beim Fußballspielen antreffen.
< PREVIOUS Wie extrahiere ich Tabellendaten aus einer PDF-Datei in C#?
NÄCHSTES > PDF/A-Konformität (Wie es für Entwickler funktioniert)