Konvertieren von ASPX-Seiten in PDF in C# ASP.NET

Wann sollte ich über DLL statt NuGet installieren?

Alternativ können Sie die IronPDF DLL herunterladen und manuell in das Projekt oder das GAC von Herunterladen IronPDF Package installieren. Für Windows-spezifische Installationen lesen Sie bitte unsere Windows-Installationsanleitung.

Vergessen Sie nicht, dieser Anweisung an die Spitze einer beliebigen cs-Klassendatei, die IronPDF verwendet, hinzuzufügen:

using IronPdf;

using IronPdf;

Wie kann ich das Anzeigeverhalten von PDF-Dateien steuern?

"InBrowser"-Dateiverhalten versucht, das PDF direkt im Browser des Benutzers anzuzeigen. Dies ist ein gängiges Merkmal moderner, standardkonformer Browser.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

"Attachment"-Dateiverhalten bewirkt, dass das PDF heruntergeladen wird.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

Wie kann ich den Dateinamen der PDF-Datei anpassen?

Legen Sie den Dateinamen des PDF-Dokuments fest, indem Sie einen zusätzlichen Parameter hinzufügen. Dies steuert den Dateinamen, wenn Benutzer die Datei herunterladen oder speichern.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

Welche PDF-Druckoptionen kann ich konfigurieren?

Steuern Sie die PDF-Ausgabe, indem Sie eine Instanz der IronPdf.ChromePdfRenderer-Klasse hinzufügen. ChromePdfRenderer API-Referenz

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-3.cs

var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
{
    EnableJavaScript = false,
    //.. many more options available
};
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);

Die verfügbaren PDF-Rendering-Optionen umfassen:

• CreatePdfFormsFromHtml: Verwandelt ASPX-Formulare in editierbare PDF-Formulare. Siehe Erstellung von PDF-Formularen.
• CssMediaType: Bildschirm oder Druck CSS-Stile. Siehe Vergleichsbilder.
• CustomCssUrl: Wendet benutzerdefiniertes CSS auf HTML an, bevor es gerendert wird. Lokaler Dateipfad oder Remote-URL.
• EnableMathematicalLaTex: Aktiviert/deaktiviert die Darstellung von LaTeX-Elementen.
• EnableJavaScript: Führt JavaScript vor dem Rendern aus. Ideal für Ajax/Angular-Anwendungen. Siehe WaitFor Anleitung.
• Javascript: Benutzerdefiniertes JavaScript, das nach dem Laden von HTML, aber vor dem Rendering ausgeführt wird.
• JavascriptMessageListener: Callback für Browser-JavaScript-Konsolenmeldungen.
• FirstPageNumber: Beginnende Seitenzahl für Kopf- und Fußzeilen. Standard ist 1.
• TableOfContents: Erzeuge TOC bei Element mit id "ironpdf-toc". Siehe TOC-Leitfaden.
• TextHeader: Setzt den Inhalt der Kopfzeile als Text. Unterstützt Mail-Merge und automatisch verlinkte URLs.
• TextFooter: Setzt den Inhalt der Fußzeile als Text. Unterstützt Mail-Merge und automatisch verlinkte URLs.
• HtmlHeader: Setzt Kopfzeileninhalte mit HTML.
• HtmlFooter: Setzt den Inhalt der Fußzeile mit HTML.
• MarginBottom: Unterer Rand in Millimetern. Null für grenzenlos.
• MarginLeft: Linker Rand in Millimetern. Null für grenzenlos.
• MarginRight: Rechter Rand in Millimetern. Null für grenzenlos.
• MarginTop: Oberer Rand in Millimetern. Null für grenzenlos.
• UseMarginsOnHeaderAndFooter: Verwende die Ränder des Hauptdokuments für Kopf- und Fußzeilen.
• PaperFit: Virtueller Papierlayout-Manager. Enthält Optionen für Chrome-Verhalten, Zoom, Responsive CSS3, Scale-to-Page und Continuous Feed. Siehe viewport guide.
• PaperOrientation: PDF-Ausrichtung - Querformat oder Hochformat.
• PageRotation: Drehen Sie die Seiten eines bestehenden Dokuments. Siehe Orientierungsbeispiele.
• PaperSize: Ausgabe der Papiergröße mit System.Drawing.Printing.PaperKind.
• SetCustomPaperSizeeinCentimeters: Legt die Papiergröße in Zentimetern fest.
• SetCustomPaperSizeInInches: Setzt die Papiergröße in Zoll.
• SetCustomPaperSizeinMilimeters: Legt die Papiergröße in Millimetern fest.
• SetCustomPaperSizeinPixelsOrPoints: Setzt die Papiergröße in Pixeln oder Punkten.
• ForcePaperSize: Erzwingt exakte Papiergröße durch Größenanpassung nach der Erzeugung.
• PrintHtmlBackgrounds: Druckt HTML-Bildhintergründe.
• GrayScale: Ausgabe von PDF in Graustufen. Siehe Graustufen-Konvertierung.
• WaitFor: Konfiguration für Wartemechanismen:
  • PageLoad: Standard-Rendering ohne Wartezeit.
  • RenderDelay: Beliebige Wartezeit.
  • Schriftarten: Warten Sie, bis die Schriftarten geladen sind.
  • JavaScript: Rendering mit JavaScript-Funktion auslösen.
  • HTML-Elemente: Suchen Sie nach bestimmten Elementen nach ID, Name, Tag oder Selektor.
  • NetworkIdle: Warte auf den Leerlauf des Netzwerks (0, 2, oder benutzerdefiniert).
• Titel: Metadaten zum Titel des PDF-Dokuments. Siehe Metadaten-Leitfaden.
• InputEncoding: Zeichenkodierung. UTF-8 ist Standard. Siehe UTF-8-Leitfaden.
• RequestContext: Anforderungskontext für Rendering.
• Timeout: Rendering Timeout in Sekunden.

Wie implementiere ich Kopf- und Fußzeilen?

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-4.cs

using IronSoftware.Drawing;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                TextHeader = new IronPdf.TextHeaderFooter()
                {
                    CenterText = "Invoice",
                    DrawDividerLine = false,
                    Font = FontTypes.Arial,
                    FontSize = 12
                },
                TextFooter = new IronPdf.TextHeaderFooter()
                {
                    LeftText = "{date} - {time}",
                    RightText = "Page {page} of {total-pages}",
                    Font = IronSoftware.Drawing.FontTypes.Arial,
                    FontSize = 12,
                },
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);
        }
    }
}

Alternativ können Sie HTML-Kopf- und -Fußzeilen mit der Klasse HtmlHeaderFooter erstellen, die CSS, Bilder und Hyperlinks unterstützt.

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-5.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                MarginTop = 50, // make sufficiant space for an HTML header
                HtmlHeader = new IronPdf.HtmlHeaderFooter()
                {
                    HtmlFragment = "<div style='text-align:right'><em style='color:pink'>page {page} of {total-pages}</em></div>"
                }
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "MyDocument.pdf", AspxToPdfOptions);
        }
    }
}

Wie in unseren Beispielen zu sehen, fügen Sie dynamischen Text oder HTML mit Hilfe von Platzhaltern in Kopf- und Fußzeilen ein:

• {page}: Aktuelle Seitenzahl.
• {total-pages}: Gesamtzahl der Seiten.
• {url}: Web-URL, von der die PDF-Datei gerendert wurde.
• {date}: Das heutige Datum im Systemformat.
• {time}: Zeit im 24-Stunden-Format.
• {html-title}: Titel aus dem ASPX-Head-Tag.
• {pdf-title}: Dateiname des Dokuments.