ASPX Pages to PDF in ASP.NET

3.1. PDF-Dateiverhalten festlegen

"InBrowser"-Dateiverhalten versucht, das PDF direkt im Browser des Benutzers anzuzeigen. Dies ist nicht immer in jedem Webbrowser möglich, aber typischerweise eine übliche Funktion moderner, standardkonformer Browser.

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

3.2. PDF-Dateiname festlegen

Wir können auch den Dateinamen des PDF-Dokuments festlegen, indem wir einen zusätzlichen Parameter hinzufügen. Das bedeutet, dass wir den Namen der Datei steuern können, wenn der Benutzer entscheidet, sie herunterzuladen oder zu behalten. Wenn wir die ASPX-Seite als PDF speichern, wird diesem PDF-Dokument dieser Name zugewiesen.

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

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

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

3.3. PDF-Druckoptionen ändern

Wir können die Ausgabe des PDFs steuern, indem wir 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);

Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {.EnableJavaScript = False}
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions)

Die verfügbaren PDF-Rendering-Optionen umfassen:

• CreatePdfFormsFromHtml Wandelt ASPX-Formularelemente in bearbeitbare PDF-Formulare um.
• CssMediaType Screen oder Print CSS Styles und Stylesheets. Siehe unser vollständiges, tiefgründiges Tutorial mit Vergleichsbildern.
• CustomCssUrl Ermöglicht es, ein benutzerdefiniertes CSS-Stylesheet auf HTML anzuwenden, bevor gerendert wird. Kann ein lokaler Dateipfad oder eine entfernte URL sein.
• EnableMathematicalLaTex Erlaubt oder verhindert, dass mathematischen LaTeX-Elemente gerendert werden.
• EnableJavaScript Erlaubt die Ausführung von JavaScript und JSON, bevor die Seite gerendert wird. Ideal zum Drucken von Ajax / Angular-Anwendungen. Siehe auch WaitFor-Anleitung.
• Javascript Gibt einen benutzerdefinierten JavaScript-String an, der ausgeführt werden soll, nachdem das gesamte HTML geladen wurde, aber vor dem PDF-Rendering.
• JavascriptMessageListener Eine Methode, die aufgerufen wird, wenn eine JavaScript-Konsolennachricht des Browsers verfügbar wird.
• FirstPageNumber Erstseitennummer für Header und Footer. Standard ist 1.
• TableOfContents Erzeugt ein Inhaltsverzeichnis an der Stelle im HTML-Dokument, an der ein Element mit der ID "ironpdf-toc" gefunden wird.
• TextHeader Legt den Footer-Inhalt für jede PDF-Seite fest. Unterstützt 'Mail-Merge' und wandelt URLs automatisch in Links um.
• TextFooter Legt den Header-Inhalt für jede PDF-Seite fest. Unterstützt 'Mail-Merge' und wandelt URLs automatisch in Links um.
• HtmlHeader Legt den Header-Inhalt für jede PDF-Seite mit Inhaltsstrings oder sogar HTML fest.
• HtmlFooter Legt den Footer-Inhalt für jede PDF-Seite mit Inhaltsstrings oder sogar HTML fest.
• MarginBottom Unterer PDF-Papier-Rand in Millimetern. Auf null setzen für eine randlose pdf.
• MarginLeft Linker PDF-Papier-Rand in Millimetern. Auf null setzen für eine randlose pdf.
• MarginRight Rechter PDF-Papier-Rand in Millimetern. Auf null setzen für eine randlose pdf.
• MarginTop Oberer PDF-Papier-Rand in Millimetern. Auf null setzen für eine randlose pdf.
• UseMarginsOnHeaderAndFooter Gibt an, ob die Randwerte aus dem Hauptdokument beim Rendern der Header und Footer verwendet werden sollen.
• PaperFit: Ein Manager für das Einrichten virtueller Papierlayouts, steuert die Layoutgestaltung von Inhalten auf PDF-„Papier“-Seiten. Enthält Optionen für Standard-Chrome-Verhalten, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed-Stil PDF-Seiten-Setups.
• PaperOrientation Die PDF-Papierausrichtung. Landschaft oder Porträt.
• PageRotation Seitenrotation aus bestehendem Dokument. Vollständige Erklärung und begleitendes Codebeispiel.
• PaperSize Setzen einer Ausgabe-Papiergröße für PDF-Seiten unter Verwendung von System.Drawing.Printing.PaperKind.
• SetCustomPaperSizeinCentimeters Setzt die Papiergröße in Zentimetern.
• SetCustomPaperSizeInInches Setzt die Papiergröße in Zoll.
• SetCustomPaperSizeinMilimeters Setzt die Papiergröße in Millimetern.
• SetCustomPaperSizeinPixelsOrPoints Setzt die Papiergröße in Bildschirm-Pixeln oder Drucker-Punkten.
• ForcePaperSize Gibt an, ob Seitengrößen genau entsprechend dem mit PaperSize festgelegten Wert durch Neugestaltung der Seite nach Erzeugung eines PDFs von HTML erzwungen werden sollen.
• PrintHtmlBackgrounds Druckt HTML-Bildhintergründe.
• GrayScale Gibt ein Graustufen-PDF in Graustufen anstelle von Vollfarb-PDF aus.
• WaitFor Ein Wrapper-Objekt, das Konfiguration für den Wait-for-Mechanismus enthält. Dies kann nützlich sein, wenn man das Rendering von JavaScript, Ajax oder Animationen betrachtet.
  • PageLoad: Standardrendition ohne Warten.
  • RenderDelay: Einstellen einer beliebigen Wartezeit.
  • Fonts: Wartet, bis alle Schriftarten geladen sind.
  • JavaScript: Auslösen des Renderns mit einer JavaScript-Funktion.
  • HTML elements: Wartet auf spezifische HTML-Elemente, wie Element-IDs, Namen, Tagnamen und Abfrageauswahlen, um Elemente zu targetieren.
  • NetworkIdle: Warten auf Netzwerk-Idle (0, 2 oder eine benutzerdefinierte Menge).
• Title PDF-Dokument 'Title'-Metadaten.
• InputEncoding Die Eingabezeichenkodierung als String. UTF-8 ist Standard für ASP.NET.
• RequestContext Gibt den Anforderungs-Kontext für das Rendering an.
• Timeout. Render-Timeout in Sekunden.

4.1. ASPX zu PDF Header- & Footer-Beispiel

: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);
        }
    }
}

Imports IronSoftware.Drawing
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace AspxToPdfTutorial
	Partial Public Class Invoice
		Inherits System.Web.UI.Page

		Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
			Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {
				.TextHeader = New IronPdf.TextHeaderFooter() With {
					.CenterText = "Invoice",
					.DrawDividerLine = False,
					.Font = FontTypes.Arial,
					.FontSize = 12
				},
				.TextFooter = New IronPdf.TextHeaderFooter() With {
					.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)
		End Sub
	End Class
End Namespace

Alternativ können wir HTML-Kopf- und Fußzeilen mithilfe der HtmlHeaderFooter-Klasse erzeugen, die auch 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);
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace AspxToPdfTutorial
	Partial Public Class Invoice
		Inherits System.Web.UI.Page

		Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
			Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {
				.MarginTop = 50,
				.HtmlHeader = New IronPdf.HtmlHeaderFooter() With {.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)
		End Sub
	End Class
End Namespace

Wie in unseren Beispielen zu sehen, können wir dynamischen Text oder HTML mithilfe von Platzhaltern in Header Footers „zusammenführen“:

• {page}: für die aktuelle Seitennummer des PDFs.
• {total-pages}: als die Gesamtanzahl der Seiten im PDF.
• {url}: Web-URL, von der das PDF-Dokument gerendert wurde.
• {date}: für das heutige Datum im Format, das für die Systemumgebung des Servers geeignet ist.
• {time}: für die Zeit in Stunden: Sekunden mit einer 24-Stunden-Uhr.
• {html-title}: fügt das title aus dem Head-Tag des ASPX-Webformulars ein.
• {pdf-title}: für den Dokumentdateinamen.