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

1. Erstellen Sie ein ASP.NET-Projekt mit Visual Studio oder einer IDE Ihrer Wahl.

2. Installieren Sie IronPDF und richten Sie Ihren Lizenzschlüssel ein.

3. Erstellen Sie einen neuen Controller oder eine Seite, auf der Sie die PDF-Konvertierung durchführen möchten.

4. Schreiben Sie Ihre Konvertierungslogik innerhalb des Controllers.

5. 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-Dateien konvertieren. Durch die vollständige Unterstützung moderner Webstandards können Sie sicher sein, dass IronPDF aus Ihren HTML-Seiten stets pixelgenaue PDF-Dateien erzeugt. IronPDF kann auch PDF-Dateien aus anderen Formaten wie DOCX, Bilder, RTF und mehr konvertieren.
• PDF-Erzeugung: Mit IronPDF können Sie aus jeder Webseite, ASPX-Datei, HTML-Zeichenfolge usw. PDFs erzeugen.
• Sicherheitsfunktionen: Mit IronPDF können Sie immer sicher sein, dass alle sensiblen PDF-Dateien dank seiner Sicherheitsfunktionen sicher 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, editieren 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 Web App erstellen(Model-View-Controller).

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

ASP.NET MVC verwendet Controller zur Bearbeitung von Benutzeranfragen. 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, d. h. sie kann Webanfragen bearbeiten und Antworten senden.

• Die Methode GeneratePdf in diesem Controller verarbeitet eine Anfrage zur Konvertierung von HTML in ein PDF-Dokument und gibt das Ergebnis zurück.

  Wenn ein Benutzer eine URL aufruft, die mit der GeneratePdf-Aktion verknüpft ist, wird die Methode ausgeführt.

• IActionResult: Dies ist der Rückgabetyp, der die Antwort darstellt, die die Webanwendung an den Benutzer zurücksendet. Es könnte eine Ansicht sein(HTML-Seite)herunterladen von Dateien, usw. In diesem Fall handelt es sich um eine PDF-Datei.

  • GeneratePdf() Methode:

    • Innerhalb der Methode definieren wir eine Zeichenkette htmlContent, die den HTML-Code enthält, den Sie in eine PDF-Datei konvertieren möchten. Zum Beispiel: "

      Hallo, IronPDF!

      Dies ist eine aus HTML generierte PDF-Datei.

      ".

    • Wir erstellen eine neue Instanz vonChromePdfRendererdie die Konvertierung von HTML in PDF übernimmt.
  • Die MethodeRenderHtmlAsPdf() 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 Controller-Methoden abbilden(aktionen). Wenn Sie beispielsweise im Browser zu /Pdf/GeneratePdf navigieren, sucht ASP.NET nach dem PdfController und ruft dessen Methode GeneratePdf auf. 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 Reihe von leistungsstarken PDF-Anpassungswerkzeugen, wie z. Bmargen, kopfzeilen/Fußzeilen, benutzerdefinierte PDF-Größeund 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

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 verfügt über eine Vielzahl von Funktionen, die für die Erstellung hochwertiger PDF-Dokumente genutzt werden können. Weitere Funktionen und detaillierte Anpassungen finden Sie in der IronPDFdokumentationund mit seiner schnelleninstallationmit dieser Übersetzung können Sie IronPDF in kürzester Zeit in Ihrem Projekt einrichten.