HTML in PDF konvertieren in C#

In diesem Handbuch finden Sie Informationen darüber, wie Sie ein HTML-Dokument mit der Aspose.HTML for .NET-Bibliothek in ein Portable Document Format (PDF) konvertieren können. Wir werden im Detail behandeln, wie man HTML in PDF konvertiert, indem man die ConvertHTML() Methoden der Converter Klasse benutzt, und wie man PdfSaveOptions und ICreateStreamProvider Parameter anwendet.

Um mit diesem Tutorial fortzufahren, sollten Sie die Aspose.HTML for .NET-Bibliothek in Ihrem C#-Projekt installieren und konfigurieren. Unsere Code-Beispiele helfen Ihnen, HTML in PDF zu konvertieren und PDF-Dateien mit der C#-Bibliothek zu erzeugen.

HTML zu PDF mit einer einzigen Codezeile

Die Konvertierung von HTML in PDF ist sehr beliebt. Um diese Funktion auszuführen, bietet Aspose.HTML for .NET die statischen Methoden der Klasse Converter als verständliche und unkomplizierte Möglichkeit, HTML-Code in eine PDF-Datei zu konvertieren – und das buchstäblich mit einer einzigen Codezeile!

1// Convert HTML to PDF using C#
2
3// Invoke the ConvertHTML() method to convert HTML to PDF
4Converter.ConvertHTML(@"<h1>Convert HTML to PDF!</h1>", ".", new PdfSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.pdf"));

Online HTML-Konverter

Sie können die Aspose.HTML API-Funktionalität überprüfen und HTML in Echtzeit konvertieren. Bitte laden Sie HTML aus dem lokalen Dateisystem, wählen Sie das Ausgabeformat und führen Sie das Beispiel aus. Im Beispiel sind die Speicheroptionen standardmäßig eingestellt. Sie erhalten das Ergebnis sofort als separate Datei.

                
            

Wenn Sie HTML in PDF programmatisch konvertieren möchten, sehen Sie sich bitte die folgenden C#-Codebeispiele an.

HTML in PDF konvertieren in C#

Bei jeder Konvertierung von HTML in PDF müssen Sie ein HTML-Dokument laden und es im PDF-Format speichern. Sie können HTML aus einer Datei, einem HTML-Code, einem Stream oder einer URL laden (siehe den Artikel Erstellen eines HTML-Dokuments). Es kann sich um verschiedene Szenarien handeln, die jedoch in wenigen Schritten erledigt werden können:

  1. Laden Sie eine HTML-Datei mit einem der HTMLDocument()-Konstruktoren der Klasse HTMLDocument. In diesem Beispiel verwenden wir den Konstruktor HTMLDocument(string), der ein HTML-Dokument aus einer Datei initialisiert.
  2. Erstellen Sie ein neues PdfSaveOptions Objekt.
  3. Verwenden Sie die Methode ConvertHTML() der Klasse Converter, um HTML als PDF-Datei zu speichern. Sie müssen der Methode ConvertHTML() das HTMLDocument, die PdfSaveOptions und den Pfad der Ausgabedatei übergeben, um HTML in PDF zu konvertieren.

Um in diesem Leitfaden fortzufahren, benötigen wir eine HTML-Datei, mit der wir arbeiten können. Hier ist eine Beispiel-HTML-Datei, die wir im nächsten C#-Beispiel verwenden werden – spring.html. Wenn Sie sie in Ihrem Browser öffnen, sollten Sie sehen:

Text “Die Abbildung illustriert die Datei spring.html”

Bitte sehen Sie sich den folgenden C#-Codeausschnitt an, der den Konvertierungsprozess von HTML in PDF für die Datei spring.html zeigt.

 1// Convert HTML to PDF in C#
 2
 3// Prepare a path to a source HTML file
 4string documentPath = Path.Combine(DataDir, "spring.html");
 5
 6// Prepare a path to save the converted file
 7string savePath = Path.Combine(OutputDir, "spring-output.pdf");
 8
 9// Initialize an HTML document from the file
10using HTMLDocument document = new HTMLDocument(documentPath);
11
12// Initialize PdfSaveOptions
13PdfSaveOptions options = new PdfSaveOptions();
14
15// Convert HTML to PDF
16Converter.ConvertHTML(document, options, savePath);

Optionen speichern

Die PDF-Erstellungsfunktionalität kann mit Speicheroptionen nach Ihren Bedürfnissen erweitert werden. Aspose.HTML ermöglicht die Konvertierung von HTML in PDF mit Standard- oder benutzerdefinierten Speicheroptionen. die Verwendung von PdfSaveOptions ermöglicht es Ihnen, den Rendering-Prozess anzupassen; Sie können die Seitengröße, Ränder, Dateiberechtigungen, Css usw. angeben.

PropertyDescription
JpegQualitySpecifies the quality of JPEG compression for images. The default value is 95.
CssGets a CssOptions object which is used for configuration of CSS properties processing.
DocumentInfoThis property contains information about the output PDF document.
BackgroundColorThis property sets the color that will fill the background of every page. By default, this property is Transparent.
PageSetupThis property gets a page setup object and uses it for configuration output page-set.
HorizontalResolutionSets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolutionSets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
EncryptionThis property gets or sets encryption details. If it is not set, then no encryption will be performed.

Um mehr über PdfSaveOptions zu erfahren, lesen Sie bitte den Artikel Feinabstimmungskonverter. Sie können die vollständigen Beispiele und Datendateien von GitHub herunterladen.

HTML in PDF konvertieren in C# mit PdfSaveOptions

Mit Aspose.HTML können Sie Dateien programmatisch konvertieren und haben dabei die volle Kontrolle über eine Vielzahl von Konvertierungsparametern. Um HTML in PDF mit PdfSaveOptions zu konvertieren, sollten Sie ein paar Schritte befolgen:

  1. Laden Sie eine HTML-Datei mit einem der HTMLDocument()-Konstruktoren der Klasse HTMLDocument.
  2. Erstellen Sie ein neues PdfSaveOptions Objekt und geben Sie die erforderlichen Eigenschaften an. Die Klasse PdfSaveOptions bietet zahlreiche Eigenschaften, die Ihnen die volle Kontrolle über eine Vielzahl von Parametern geben und den Prozess der Konvertierung von HTML in das PDF-Format verbessern.
  3. Verwenden Sie die Methode ConvertHTML() der Klasse Converter, um HTML als PDF-Datei zu speichern. Die Methode ConvertHTML() nimmt die Parameter document, options und den Pfad der Ausgabedatei savePath entgegen und führt die Konvertierung durch.

Das folgende Beispiel zeigt, wie Sie PdfSaveOptions verwenden und eine PDF-Datei mit benutzerdefinierten Speicheroptionen erstellen:

 1// Convert HTML to PDF in C# with custom page settings
 2
 3// Prepare a path to a source HTML file
 4string documentPath = Path.Combine(DataDir, "drawing.html");
 5
 6// Prepare a path to save the converted file
 7string savePath = Path.Combine(OutputDir, "drawing-options.pdf");
 8
 9// Initialize an HTML document from the file
10using HTMLDocument document = new HTMLDocument(documentPath);
11
12// Initialize PdfSaveOptions. Set up the page-size 600x300 pixels, margins, resolutions and change the background color to AliceBlue 
13PdfSaveOptions options = new PdfSaveOptions()
14{
15    HorizontalResolution = 200,
16    VerticalResolution = 200,
17    BackgroundColor = System.Drawing.Color.AliceBlue,
18    JpegQuality = 100
19};
20options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(600, 300), new Margin(20, 10, 10, 10));
21
22// Convert HTML to PDF
23Converter.ConvertHTML(document, options, savePath);

Die Umwandlung von HTML in PDF kann flexibel angepasst werden, um das gewünschte Ergebnis zu erzielen. In den folgenden Artikeln finden Sie Antworten auf häufig gestellte Fragen zur Konvertierung von HTML in PDF:

Output-Stream-Anbieter

Wenn es erforderlich ist, Dateien in einem entfernten Speicher (z. B. Cloud, Datenbank usw.) zu speichern, können Sie die Schnittstelle ICreateStreamProvider implementieren, um die manuelle Kontrolle über den Dateierstellungsprozess zu haben. Diese Schnittstelle ist als Callback-Objekt zur Erstellung eines Streams am Anfang des Dokuments/der Seite (je nach Ausgabeformat) und zur Freigabe des früh erstellten Streams nach dem Rendern des Dokuments/der Seite konzipiert.

Die Aspose.HTML C# Bibliothek ermöglicht die Realisierung der MemoryStreamProvider Klasse als eine eigene Implementierung der ICreateStreamProvider Schnittstelle. Die MemoryStreamProvider-Klasse bietet C# MemoryStream-Objekte als Ausgabestreams zum Schreiben von Daten, die im Speicher als Stream gespeichert werden können:

 1// Implement a custom MemoryStream provider for advanced control over HTML rendering output streams
 2
 3class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
 4{
 5    // List of MemoryStream objects created during the document rendering
 6    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();
 7
 8    public Stream GetStream(string name, string extension)
 9    {
10        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
11        MemoryStream result = new MemoryStream();
12        Streams.Add(result);
13        return result;
14    }
15
16    public Stream GetStream(string name, string extension, int page)
17    {
18        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
19        MemoryStream result = new MemoryStream();
20        Streams.Add(result);
21        return result;
22    }
23
24    public void ReleaseStream(Stream stream)
25    {
26        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
27    }
28
29    public void Dispose()
30    {
31        // Releasing resources
32        foreach (MemoryStream stream in Streams)
33            stream.Dispose();
34    }
35}

Aspose.HTML for .NET bietet verschiedene Arten von Ausgabeformaten für Rendering-Operationen. Einige dieser Formate erzeugen eine einzige Ausgabedatei (z.B. PDF, XPS), während andere mehrere Dateien erzeugen (Bildformate JPG, PNG, etc.).

Der folgende C#-Code zeigt, wie die Klasse MemoryStreamProvider und die Aspose.HTML for .NET-Bibliothek verwendet werden, um HTML in PDF zu konvertieren und das Ergebnis in einer Datei zu speichern.

 1// Convert HTML to PDF in C# using memory stream
 2
 3// Create an instance of MemoryStreamProvider
 4using MemoryStreamProvider streamProvider = new MemoryStreamProvider();
 5
 6// Initialize an HTML document
 7using HTMLDocument document = new HTMLDocument(@"<h1>Convert HTML to PDF File Format!</h1>", ".");
 8
 9// Convert HTML to PDF using the MemoryStreamProvider
10Converter.ConvertHTML(document, new PdfSaveOptions(), streamProvider);
11
12// Get access to the memory stream that contains the result data
13MemoryStream memory = streamProvider.Streams.First();
14memory.Seek(0, SeekOrigin.Begin);
15
16// Flush the result data to the output file
17using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.pdf")))
18{
19    memory.CopyTo(fs);
20}

Sie können die vollständigen Beispiele und Datendateien von GitHub herunterladen.

Laden Sie die Bibliothek Aspose.HTML for .NET herunter, mit der Sie Ihre HTML-, MHTML-, EPUB-, SVG- und Markdown-Dokumente erfolgreich, schnell und einfach in die gängigsten Formate konvertieren können.

Aspose.HTML bietet einen kostenlosen Online HTML zu PDF Konverter, der HTML in PDF mit hoher Qualität, einfach und schnell konvertiert. Einfach hochladen, Ihre Dateien konvertieren und das Ergebnis in wenigen Sekunden erhalten!

Text “HTML zu PDF Konverter”

Subscribe to Aspose Product Updates

Get monthly newsletters & offers directly delivered to your mailbox.