Konwersja stron ASPX do formatu PDF w języku C# ASP.NET

Kiedy należy zainstalować bibliotekę za pomocą pliku DLL zamiast NuGet?

Alternatywnie można pobrać bibliotekę DLL IronPDF i ręcznie zainstalować ją w projekcie lub w GAC, korzystając z opcji Pobierz pakiet IronPDF. W przypadku instalacji specyficznych dla systemu Windows zapoznaj się z naszym przewodnikiem instalacji dla systemu Windows.

Pamiętaj, aby dodać to wyrażenie na górze dowolnego pliku klasy cs używającego IronPDF:

using IronPdf;

using IronPdf;

Imports IronPdf

Jak kontrolować sposób wyświetlania plików PDF?

Zachowanie pliku "InBrowser" próbuje pokazać PDF bezpośrednio w przeglądarce użytkownika. Jest to powszechna funkcja nowoczesnych przeglądarek zgodnych ze standardami.

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

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

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

Zachowanie pliku "Attachment" powoduje pobranie PDF.

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

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

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

Jak dostosować nazwę pliku PDF?

Ustaw nazwę pliku dokumentu PDF, dodając dodatkowy parametr. To kontroluje nazwę pliku, gdy użytkownicy pobierają lub zapisują plik.

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

Jakie opcje drukowania PDF mogę skonfigurować?

Kontroluj wyjście PDF, dodając instancję klasy IronPdf.ChromePdfRenderer. Dokumentacja API ChromePdfRenderer

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

Dostępne opcje renderowania plików PDF obejmują:

• CreatePdfFormsFromHtml: Zamienia formularze ASPX na edytowalne formularze PDF. Zobacz tworzenie formularzy PDF.
• CssMediaType: Screen lub Print Style CSS. Zobacz zdjęcia porównawcze.
• CustomCssUrl: Zastosuj niestandardowy CSS do HTML przed renderowaniem. Lokalna ścieżka pliku lub zdalny URL.
• EnableMathematicalLaTex: Włącz/wyłącz renderowanie elementów LaTeX.
• EnableJavaScript: Wykonaj JavaScript przed renderowaniem. Idealny dla aplikacji Ajax/Angular. Zobacz Przewodnik WaitFor.
• JavaScript: Niestandardowy JavaScript do wykonania po załadowaniu HTML, ale przed renderowaniem.
• JavaScriptMessageListener: Callback dla wiadomości konsolowych JavaScript przeglądarki.
• FirstPageNumber: Numer początkowy strony dla nagłówków/stopki. Domyślnie 1.
• TableOfContents: Generuj spis treści w elemencie z id "ironpdf-toc". Zobacz przewodnik TOC.
• TextHeader: Ustaw treść nagłówka jako tekst. Obsługuje scalanie poczty i automatyczne linkowanie URLi.
• TextFooter: Ustaw treść stopki jako tekst. Obsługuje scalanie poczty i automatyczne linkowanie URLi.
• HtmlHeader: Ustaw treść nagłówka za pomocą HTML.
• HtmlFooter: Ustaw treść stopki za pomocą HTML.
• MarginBottom: Dolny margines w milimetrach. Zero dla bezramkowego.
• MarginLeft: Lewy margines w milimetrach. Zero dla bezramkowego.
• MarginRight: Prawy margines w milimetrach. Zero dla bezramkowego.
• MarginTop: Górny margines w milimetrach. Zero dla bezramkowego.
• UseMarginsOnHeaderAndFooter: Użyj marginesów głównego dokumentu dla nagłówków/stopki.
• PaperFit: Wirtualny menedżer układu papieru. Zawiera opcje dotyczące zachowania Chrome, zoomu, responsywnego CSS3, skalowania na stronę i ciągłego podawania. Zobacz przewodnik dotyczący widoku.
• PaperOrientation: Orientacja PDF - Pozioma lub Pionowa.
• PageRotation: Obróć strony z istniejącego dokumentu. Zobacz przykłady orientacji.
• PaperSize: Rozmiar papieru wyjściowego za pomocą System.Drawing.Printing.PaperKind.
• SetCustomPaperSizeinCentimeters: Ustaw rozmiar papieru w centymetrach.
• SetCustomPaperSizeInInches: Ustaw rozmiar papieru w calach.
• SetCustomPaperSizeinMilimeters: Ustaw rozmiar papieru w milimetrach.
• SetCustomPaperSizeinPixelsOrPoints: Ustaw rozmiar papieru w pikselach lub punktach.
• ForcePaperSize: Wymuś dokładny rozmiar papieru przez przeskalowanie po wygenerowaniu.
• PrintHtmlBackgrounds: Drukuj tła obrazów HTML.
• GrayScale: Wyjściowy PDF w skali szarości. Zobacz konwersję na skalę szarości.
• WaitFor: Konfiguracja mechanizmów oczekiwania:
  • PageLoad: Domyślne renderowanie bez oczekiwania.
  • RenderDelay: Dowolny czas oczekiwania.
  • Fonts: Oczekiwanie na załadowanie czcionek.
  • JavaScript: Wyzwól renderowanie za pomocą funkcji JavaScript.
  • HTML elements: Czekaj na konkretne elementy po ID, nazwie, tagu lub selektorze.
  • NetworkIdle: Czekaj na bezczynność sieci (0, 2 lub niestandardową).
• Title: Metadane tytułu dokumentu PDF. Zobacz przewodnik metadanych.
• InputEncoding: Kodowanie znaków. Domyślnie UTF-8. Zobacz przewodnik UTF-8.
• RequestContext: Kontekst żądania do renderowania.
• Timeout: Limit czasu renderowania w sekundach.

Jak wdrożyć nagłówki i stopki?

: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

Alternatywnie, generuj nagłówki i stopki HTML używając klasy HtmlHeaderFooter, która obsługuje CSS, obrazy i hiperłącza.

: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

Jak pokazano w naszych przykładach, scalaj dynamiczny tekst lub HTML w nagłówki/stopki używając zastępników:

• {page}: Aktualny numer strony.
• {total-pages}: Całkowita liczba stron.
• {url}: Adres URL, z którego został wyrenderowany PDF.
• {date}: Dzisiejsza data w formacie systemowym.
• {time}: Czas w formacie 24-godzinnym.
• {html-title}: Tytuł z tagu head ASPX.
• {pdf-title}: Nazwa pliku dokumentu.

Szybki dostęp do samouczka

Zapoznaj się z tym samouczkiem na GitHubie

Kod tego projektu ASPX-To-PDF w C# jest dostępny w C# i VB.NET na GitHub jako projekt strony ASP.NET. Zapraszamy do forka nas na GitHub, aby uzyskać więcej pomocy przy używaniu IronPDF. Zachęcamy do udostępniania tego każdemu, kto może zapytać "Jak przekonwertować ASPX na PDF?"

Projekt strony ASPX to PDF w C# Zaawansowane przykłady strony ASP.NET do PDF w C# do tworzenia PDF Przykłady PDF ASP.NET w VB.NET do tworzenia PDF

Pobierz przewodnik do szybkiego startu PDF C#

Aby ułatwić rozwijanie PDF w aplikacjach .NET, skompilowaliśmy przewodnik szybkiego startu w formie dokumentu PDF. Ten "Cheat-Sheet" zapewnia szybki dostęp do typowych funkcji i przykładów generowania oraz edytowania PDF w C# i VB.NET, co pomoże zaoszczędzić czas na rozpoczęcie używania IronPDF w projekcie .NET.

Pobierz

Zobacz Dokumentację API

Odkryj Dokumentację API dla IronPDF, opisującą szczegóły wszystkich funkcji, przestrzeni nazw, klas, metod, pól i enumeracji IronPDF.

Zobacz Dokumentację API IronPDF