Conversione HTML in PDF è comune, dalle fatture ai report, ma le impostazioni predefinite raramente corrispondono alle esigenze di marca e stampa. Aspose.HTML for .NET,Puoi controllare con precisione Pagina di dimensioni, Margine, Orientamento,e Le regole dei media CSS Per produrre PDF professionali e coerenti, questa guida mostra una configurazione pulita e ripetibile e include un campione completo di C#.

a dei dati

  • utilizzo Converter.ConvertHTML con PdfSaveOptions Per una robusta conversione HTML → PDF.
  • Configurazione PageSetup.AnyPage 2 Set dimensioni e Margine (A4/A3/custom); scegliere il ritratto o il paesaggio per dimensione.
  • Applicare options.Css.MediaType (Il Principe vs Screen di(per rispettare il giusto CSS.
  • Genera più varianti (ad esempio, A4 ritratto + A3 paesaggio) dallo stesso HTML per diversi audience.

Guida passo per passo

1) Set up the project

Installa il pacchetto NuGet e crea un progetto di console (passaggi in Come correre).

2) Load HTML content

Caricare un file esistente o creare un HTMLDocument di una stringa. fornire a Base Uri Per risolvere CSS relativo, immagini e font.

3) Configure page geometry and media

utilizzo PdfSaveOptions.PageSetup.AnyPage Definizione dimensione e Margine,e set Css.MediaType Il target @media print Regole quando necessario.

4) Convert to PDF

Chiamate Converter.ConvertHTML(document, options, path) per scrivere il file PDF.

Crea un nuovo progetto: Seleziona il modello di progetto ASP.NET Web Application (.NET Framework).
Select project template

using System;
using System.IO;
using Aspose.Html;
using Aspose.Html.Converters;
using Aspose.Html.Saving;            // PdfSaveOptions
using Aspose.Html.Rendering;         // MediaType
using Aspose.Html.Drawing;           // Length, Size, Margin, Page

namespace HtmlToPdfCustomization
{
    internal static class Program
    {
        // How to run:
        // 1) dotnet new console -n HtmlToPdfCustomization
        // 2) cd HtmlToPdfCustomization
        // 3) dotnet add package Aspose.HTML
        // 4) Replace Program.cs with this file's contents
        // 5) dotnet run -- "path-to-input.html"   (optional)
        private static void Main(string[] args)
        {
            string outDir = Path.Combine(Directory.GetCurrentDirectory(), "out");
            Directory.CreateDirectory(outDir);

            // Load HTML from file if provided; otherwise, use inline HTML
            HTMLDocument document;
            if (args.Length > 0 && File.Exists(args[0]))
            {
                document = new HTMLDocument(args[0]);
            }
            else
            {
                string html = "<!DOCTYPE html>" +
                              "<html><head><meta charset=\\\"utf-8\\\">" +
                              "<title>HTML to PDF (Aspose.HTML)</title>" +
                              "<style>body{font-family:Arial,Helvetica,sans-serif;margin:24px}" +
                              ".lead{color:#444} table{width:100%;border-collapse:collapse}" +
                              "th,td{border:1px solid #ddd;padding:6px 8px;text-align:left}" +
                              "@media print{body{font-size:12pt}.lead{color:#000}}</style>" +
                              "</head><body>" +
                              "<h1>Order Summary</h1>" +
                              "<p class=\\\"lead\\\">This PDF respects print CSS and custom page settings.</p>" +
                              "<table><tr><th>Item</th><th>Qty</th><th>Price</th></tr>" +
                              "<tr><td>Widget A</td><td>3</td><td>$12.00</td></tr>" +
                              "<tr><td>Widget B</td><td>2</td><td>$9.50</td></tr></table>" +
                              "</body></html>";
                document = new HTMLDocument(html, ".");
            }

            using (document)
            {
                var mm = Length.FromMillimeters;

                // Variant 1: A4 portrait with 12.7 mm margins, using print CSS
                var a4 = new PdfSaveOptions();
                a4.Css.MediaType = MediaType.Print;
                a4.PageSetup.AnyPage = new Page(
                    new Size(mm(210), mm(297)), // A4
                    new Margin(mm(12.7), mm(12.7), mm(12.7), mm(12.7))
                );
                string a4Path = Path.Combine(outDir, "order-a4.pdf");
                Converter.ConvertHTML(document, a4, a4Path);
                Console.WriteLine($"Saved: {a4Path}");

                // Variant 2: A3 landscape with tighter margins, using screen CSS
                var a3Landscape = new PdfSaveOptions();
                a3Landscape.Css.MediaType = MediaType.Screen;
                a3Landscape.PageSetup.AnyPage = new Page(
                    new Size(mm(420), mm(297)), // A3 landscape
                    new Margin(mm(10), mm(10), mm(10), mm(10))
                );
                string a3Path = Path.Combine(outDir, "order-a3-landscape.pdf");
                Converter.ConvertHTML(document, a3Landscape, a3Path);
                Console.WriteLine($"Saved: {a3Path}");

                // Variant 3: Custom 6 x 9 inches trim with narrow margins (print CSS)
                var custom = new PdfSaveOptions();
                custom.Css.MediaType = MediaType.Print;
                custom.PageSetup.AnyPage = new Page(
                    new Size(Length.FromInches(6), Length.FromInches(9)),
                    new Margin(mm(5), mm(5), mm(5), mm(5))
                );
                string customPath = Path.Combine(outDir, "order-6x9.pdf");
                Converter.ConvertHTML(document, custom, customPath);
                Console.WriteLine($"Saved: {customPath}");
            }
        }
    }
}

Aggiungi formato immagine: Allo stesso modo, aggiungi un’enumerazione per i formati di immagine supportati.

  • Carico HTML da un file o stringa in memoria con un URI di base.
  • Configurazione diPdfSaveOptions per ritratto A4, paesaggio A3 e una taglia personalizzata di 6×9 pollici.
  • applicazione diMediaType.Print o MediaType.Screen per soddisfare le regole CSS.
  • esportazioni 3 PDF in un unico formato out/ Il Folletto.

Risoluzione dei problemi e suggerimenti

  • Stili sbagliati:di toggle options.Css.MediaType tra Print e Screen per corrispondere al tuo stile.
  • Contenuti tagliati: aumentare le dimensioni delle pagine o i margini; formati più ampi aiutano le tabelle più grandi.
  • Fonti mancanti: assicurarsi che le fonti siano disponibili al render o incorporate tramite @font-face.
  • performance:semplificare DOM/CSS pesante; preferiscono le risorse statiche cache.

FAQ

Q1: Come impostare le dimensioni e i margini della pagina? utilizzo PdfSaveOptions.PageSetup.AnyPage = new Page(Size, Margin) con unità da Length (in millimetri o inchi).

Q2.Posso forzare gli stili di stampa? Sì, set options.Css.MediaType = MediaType.Print così @media print Le regole si applicano.

Q3. come faccio a rendere le pagine paesaggistiche? Proporre un paesaggio Size (ad esempio, A3 420 × 297 mm) quando si crea il Page.

Q4.Posso esportare più varianti da un unico HTML? Creare separatamente PdfSaveOptions oggetti (differenti Css.MediaType e le dimensioni) e la chiamata Converter.ConvertHTML per ciascuno di loro.

Q5: Ho bisogno di un motore di browser installato? No. Aspose.HTML rende server-side senza browser esterni.

Conclusione

utilizzando PdfSaveOptions Con CSS e media-conscious, è possibile creare PDF lucidati su misura per le esigenze di stampa, archiviazione o esecuzione. Inizia con il ritratto A4 per documenti generali, aggiungi paesaggio A3 per layout ampi e mantieni una dimensione personalizzata per i foglietti o i report.

More in this category