Die C# PDF-Bibliothek

HTML zu PDF

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >

Install-Package IronPdf

VIDEOS

Wie man Seitenorientierung und Rotation in .NET C# setzt | IronPDF

Curtis Chau

Updated: 19. Juli 2026

Der Wechsel von SelectPdfzu IronPDF verschiebt Ihren PDF-Erstellungsablauf von einer nur für Windows verfügbaren Bibliothek — deren Standard-Render-Engine ein internes WebKit ist und deren optionale Blink-Engine mit Chromium 124 (April 2024) geliefert wird — zu einer aktuellen Chromium-, plattformübergreifenden Bibliothek mit vollständigem CSS3- und JavaScript-Support. Diese Anleitung bietet einen vollständigen, schrittweisen Migrationspfad, der die Bereitstellung auf Linux, Docker, Azure Functionsund andere Cloud-Plattformen ermöglicht, die von SelectPdfnicht unterstützt werden.

Warum von SelectPdfzu IronPDF migrieren

SelectPdfverstehen

SelectPdf ist eine kommerzielle Bibliothek, die für die Konvertierung von HTML-Inhalten in PDF-Dateien mit C# entwickelt wurde. Die Bibliothek ist auf Entwickler zugeschnitten, die eine nahtlose Integration von PDF-Generierungsfunktionen in ihre Anwendungen benötigen. Die Stärke von SelectPdfliegt in seiner einfachen API, was es zu einer attraktiven Option für diejenigen macht, die neu in der PDF-Erstellung sind.

Potenzielle Benutzer müssen sich jedoch der kritischen Grenzen der Übersetzung bewusst sein. Laut eigener Dokumentation des Anbieters läuft SelectPdfnur unter Windows — nicht unter Linux, macOS oder Xamarin. Dies stellt eine erhebliche Hürde dar, wenn man cloudbasierte Bereitstellungslösungen wie Linux Azure Functionsoder Docker in Erwägung zieht. Die Community Edition ist auf 5 Seiten pro PDF begrenzt und fügt jeder Seite ein Wasserzeichen hinzu, bis ein Lizenzschlüssel erworben wird. Die Standard-Render-Engine von SelectPdfist ein internes WebKit; Der optionale Blink-Engine wird mit Chromium 124 (April 2024) geliefert, das dem aktuellen Chrome hinterherhinkt und Probleme mit neueren CSS-Funktionen wie CSS-Rasterund der Flexbox-gap-Eigenschaft verursachen kann.

Kritische Beschränkungen von SelectPdf

|Problem| Auswirkungen|IronPDF Lösung| |-------|--------|------------------| | Nur für Windows| Kann nicht auf Linux, Docker, Azure Functionsbereitgestellt werden| Vollständige plattformübergreifende Unterstützung| | Standard-WebKit-Engine; optionale Blink-Version liefert Chromium 124 (April 2024) | Neuere CSS-Funktionen können auf der Standard-Engine fehlschlagen | Aktuelles Chromium| | Beschränkung der kostenlosen Version auf 5 Seiten| Pro-Seite Wasserzeichen auf jeder Seite, bis lizenziert | Großzügige Probezeit| | .NET 10 nur unter Windows | Keine Linux/macOS/Container-Bereitstellung | Vollständige .NET 10 auf allen Plattformen | | Cloud-Bereitstellung blockiert (nicht-Windows) | Kann AWS Lambdaoder Linux Azure Functionsnicht verwenden | Cloud-nativ|

Vergleich zwischen SelectPdfund IronPDF

| Feature | SelectPdf|IronPDF| |---------|-----------|---------| |Windows, Linux, macOS, Docker, Azure, AWS.| Nur Windows| Vollständig plattformübergreifend, 10+ Distros| | Unterstützung moderner Webstandards| Standardmäßig WebKit; Blink-Option wird mit Chromium 124 (April 2024) geliefert | Vollständiges CSS3, aktuelles Chromium | | Maximale Seitenzahl der kostenlosen Version| 5 Seiten + pro-Seite Wasserzeichen | Flexibel, keine feste Grenze| | Preisgestaltung| $499 Einzelentwickler bis $1.599 Enterprise OEM | Transparente und flexible Preisgestaltung| | .NET 10 Unterstützung| Ja, aber nur Windows | Ja, alle Plattformen | | Bereitstellung in Cloud-Umgebungen| Nur für Windows-Ziele | Vollständig unterstützt (Windows + Linux) | | CSS Grid| WebKit: eingeschränkt; Blink (Chromium 124): unterstützt | Unterstützt| | Flexbox (Gap-Eigenschaft) | WebKit: nicht unterstützt; Blink: unterstützt | Unterstützt| | CSS-Variablen| WebKit: nicht unterstützt; Blink: unterstützt | Unterstützt| | Docker (Linux) | Nicht unterstützt | Offizielle Bilder| | Azure Functions (Linux) | Nicht unterstützt | Unterstützt| | AWS Lambda| Nicht unterstützt | Unterstützt|

Das NetCore-Paket von SelectPdfzielt auf .NET Standard 2.0 ab und wird als kompatibel mit .NET 5 bis .NET 10 dokumentiert — jedoch nur auf Windows, was diese Kompatibilität für jedes Team neutralisiert, das auf Linux-Containern, AWS Lambdaoder Linux-basierten Azure App Service bereitstellt.IronPDF unterstützt dieselben .NET-Versionen und läuft unter Windows, Linux, macOS und Docker.

Bevor Sie beginnen

Voraussetzungen

.NET Environment: .NET Framework 4.6.1+ or .NET Core 3.1+ / .NET 5/6/7/8/9/10+
NuGet -Zugriff: Möglichkeit zur Installation von NuGet -Paketen
IronPDF -Lizenz: Ihren Lizenzschlüssel erhalten Sie unter IronPDF.

NuGet-Paketänderungen

# Remove SelectPdf(use Select.HtmlToPdf.NetCore on .NET Core / .NET 5+)
dotnet remove package Select.HtmlToPdf
# or: dotnet remove package Select.HtmlToPdf.NetCore

# Install IronPDF
dotnet add package IronPdf

# Remove SelectPdf(use Select.HtmlToPdf.NetCore on .NET Core / .NET 5+)
dotnet remove package Select.HtmlToPdf
# or: dotnet remove package Select.HtmlToPdf.NetCore

# Install IronPDF
dotnet add package IronPdf

SHELL

Lizenz-Konfiguration

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

' Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

Komplette API-Referenz

Namensraumänderungen

// Before: SelectPdf
using SelectPdf;

// After: IronPDF
using IronPdf;
using IronPdf.Engines.Chrome;

// Before: SelectPdf
using SelectPdf;

// After: IronPDF
using IronPdf;
using IronPdf.Engines.Chrome;

' Before: SelectPdf
Imports SelectPdf

' After: IronPDF
Imports IronPdf
Imports IronPdf.Engines.Chrome

' Before: SelectPdf
Imports SelectPdf

' After: IronPDF
Imports IronPdf
Imports IronPdf.Engines.Chrome

Kern-API-Zuordnungen

| SelectPdf|IronPDF| Notizen | |-----------|---------|-------| | HtmlToPdf | ChromePdfRenderer | Core-Konverter-Klasse| | converter.ConvertHtmlString(html) | renderer.RenderHtmlAsPdf(html) | HTML-String-Konvertierung| | converter.ConvertUrl(url) | renderer.RenderUrlAsPdf(url) | URL-Konvertierung| | doc.Save(path) | pdf.SaveAs(path) | In Datei speichern| | doc.Close() | Nicht erforderlich|IronPDF übernimmt die Bereinigung| | converter.Options.PdfPageSize | renderer.RenderingOptions.PaperSize | Papierformat| | converter.Options.PdfPageOrientation | renderer.RenderingOptions.PaperOrientation | Orientierung| | converter.Options.MarginTop | renderer.RenderingOptions.MarginTop | Oberer Rand| | converter.Options.MarginBottom | renderer.RenderingOptions.MarginBottom | Unterer Rand| | converter.Options.MarginLeft | renderer.RenderingOptions.MarginLeft | Linker Rand| | converter.Options.MarginRight | renderer.RenderingOptions.MarginRight | Rechter Rand| | PdfPageSize.A4 | PdfPaperSize.A4 | A4-Format enum| | PdfPageOrientation.Portrait | PdfPaperOrientation.Portrait | Porträt enum| | PdfPageOrientation.Landscape | PdfPaperOrientation.Landscape | Landscape enum| | {page_number} | {page} | Platzhalter für die Seitenzahl| | {total_pages} | {total-pages} | Gesamtseiten Platzhalter|

Beispiele für die Code-Migration

Beispiel 1: Konvertierung von HTML-Strings in PDF

Vor (SelectPdf):

// NuGet: Install-Package Select.HtmlToPdf
using SelectPdf;
using System;

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        
        HtmlToPdf converter = new HtmlToPdf();
        PdfDocument doc = converter.ConvertHtmlString(htmlContent);
        doc.Save("document.pdf");
        doc.Close();
        
        Console.WriteLine("PDF generated from HTML string");
    }
}

// NuGet: Install-Package Select.HtmlToPdf
using SelectPdf;
using System;

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        
        HtmlToPdf converter = new HtmlToPdf();
        PdfDocument doc = converter.ConvertHtmlString(htmlContent);
        doc.Save("document.pdf");
        doc.Close();
        
        Console.WriteLine("PDF generated from HTML string");
    }
}

' NuGet: Install-Package Select.HtmlToPdf
Imports SelectPdf
Imports System

Module Program
    Sub Main()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>"

        Dim converter As New HtmlToPdf()
        Dim doc As PdfDocument = converter.ConvertHtmlString(htmlContent)
        doc.Save("document.pdf")
        doc.Close()

        Console.WriteLine("PDF generated from HTML string")
    End Sub
End Module

' NuGet: Install-Package Select.HtmlToPdf
Imports SelectPdf
Imports System

Module Program
    Sub Main()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>"

        Dim converter As New HtmlToPdf()
        Dim doc As PdfDocument = converter.ConvertHtmlString(htmlContent)
        doc.Save("document.pdf")
        doc.Close()

        Console.WriteLine("PDF generated from HTML string")
    End Sub
End Module

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("document.pdf");
        
        Console.WriteLine("PDF generated from HTML string");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("document.pdf");
        
        Console.WriteLine("PDF generated from HTML string");
    }
}

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System

Module Program
    Sub Main()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>"
        
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("document.pdf")
        
        Console.WriteLine("PDF generated from HTML string")
    End Sub
End Module

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System

Module Program
    Sub Main()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>"
        
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("document.pdf")
        
        Console.WriteLine("PDF generated from HTML string")
    End Sub
End Module

Dieses Beispiel veranschaulicht die wichtigsten API-Unterschiede. SelectPdfverwendet HtmlToPdf als Konverter-Klasse, ruft ConvertHtmlString() auf, um eine PdfDocument zu erstellen, dann Save() und Close(), um zu speichern und aufzuräumen.

IronPDF verwendet ChromePdfRenderer mit RenderHtmlAsPdf(), gibt eine PdfDocument zurück, die mit SaveAs() gespeichert wird. Der Close()-Aufruf entfällt –IronPDF verwaltet die Ressourcen automatisch. Umfassende Beispiele finden Sie in der HTML to PDF Dokumentation.

Beispiel 2: Konvertierung von URL in PDF

Vor (SelectPdf):

// NuGet: Install-Package Select.HtmlToPdf
using SelectPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf converter = new HtmlToPdf();
        PdfDocument doc = converter.ConvertUrl("https://www.example.com");
        doc.Save("output.pdf");
        doc.Close();
        
        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package Select.HtmlToPdf
using SelectPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf converter = new HtmlToPdf();
        PdfDocument doc = converter.ConvertUrl("https://www.example.com");
        doc.Save("output.pdf");
        doc.Close();
        
        Console.WriteLine("PDF created successfully");
    }
}

' NuGet: Install-Package Select.HtmlToPdf
Imports SelectPdf
Imports System

Module Program
    Sub Main()
        Dim converter As New HtmlToPdf()
        Dim doc As PdfDocument = converter.ConvertUrl("https://www.example.com")
        doc.Save("output.pdf")
        doc.Close()

        Console.WriteLine("PDF created successfully")
    End Sub
End Module

' NuGet: Install-Package Select.HtmlToPdf
Imports SelectPdf
Imports System

Module Program
    Sub Main()
        Dim converter As New HtmlToPdf()
        Dim doc As PdfDocument = converter.ConvertUrl("https://www.example.com")
        doc.Save("output.pdf")
        doc.Close()

        Console.WriteLine("PDF created successfully")
    End Sub
End Module

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("output.pdf");
        
        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("output.pdf");
        
        Console.WriteLine("PDF created successfully");
    }
}

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System

Module Program
    Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://www.example.com")
        pdf.SaveAs("output.pdf")
        
        Console.WriteLine("PDF created successfully")
    End Sub
End Module

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System

Module Program
    Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://www.example.com")
        pdf.SaveAs("output.pdf")
        
        Console.WriteLine("PDF created successfully")
    End Sub
End Module

Die ConvertUrl()-Methode von SelectPdfwird direkt auf die von IronPDF abgebildet: RenderUrlAsPdf(). Der entscheidende Unterschied liegt in der Render-Engine: SelectPdfverwendet standardmäßig ein internes WebKit und bietet eine optionale Blink-Engine, die mit Chromium 124 (April 2024) gebündelt ist, während IronPDF das aktuelle stabile Chromium für vollständigen CSS3- und JavaScript-Support verwendet. Erfahren Sie mehr in unseren Tutorials.

Beispiel 3: Benutzerdefinierte Seiteneinstellungen und Ränder

Vor (SelectPdf):

// NuGet: Install-Package Select.HtmlToPdf
using SelectPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf converter = new HtmlToPdf();
        
        converter.Options.PdfPageSize = PdfPageSize.A4;
        converter.Options.PdfPageOrientation = PdfPageOrientation.Portrait;
        converter.Options.MarginTop = 20;
        converter.Options.MarginBottom = 20;
        converter.Options.MarginLeft = 20;
        converter.Options.MarginRight = 20;
        
        string html = "<html><body><h1>Custom Page Settings</h1></body></html>";
        PdfDocument doc = converter.ConvertHtmlString(html);
        doc.Save("custom-settings.pdf");
        doc.Close();
        
        Console.WriteLine("PDF with custom settings created");
    }
}

// NuGet: Install-Package Select.HtmlToPdf
using SelectPdf;
using System;

class Program
{
    static void Main()
    {
        HtmlToPdf converter = new HtmlToPdf();
        
        converter.Options.PdfPageSize = PdfPageSize.A4;
        converter.Options.PdfPageOrientation = PdfPageOrientation.Portrait;
        converter.Options.MarginTop = 20;
        converter.Options.MarginBottom = 20;
        converter.Options.MarginLeft = 20;
        converter.Options.MarginRight = 20;
        
        string html = "<html><body><h1>Custom Page Settings</h1></body></html>";
        PdfDocument doc = converter.ConvertHtmlString(html);
        doc.Save("custom-settings.pdf");
        doc.Close();
        
        Console.WriteLine("PDF with custom settings created");
    }
}

' NuGet: Install-Package Select.HtmlToPdf
Imports SelectPdf
Imports System

Module Program
    Sub Main()
        Dim converter As New HtmlToPdf()

        converter.Options.PdfPageSize = PdfPageSize.A4
        converter.Options.PdfPageOrientation = PdfPageOrientation.Portrait
        converter.Options.MarginTop = 20
        converter.Options.MarginBottom = 20
        converter.Options.MarginLeft = 20
        converter.Options.MarginRight = 20

        Dim html As String = "<html><body><h1>Custom Page Settings</h1></body></html>"
        Dim doc As PdfDocument = converter.ConvertHtmlString(html)
        doc.Save("custom-settings.pdf")
        doc.Close()

        Console.WriteLine("PDF with custom settings created")
    End Sub
End Module

' NuGet: Install-Package Select.HtmlToPdf
Imports SelectPdf
Imports System

Module Program
    Sub Main()
        Dim converter As New HtmlToPdf()

        converter.Options.PdfPageSize = PdfPageSize.A4
        converter.Options.PdfPageOrientation = PdfPageOrientation.Portrait
        converter.Options.MarginTop = 20
        converter.Options.MarginBottom = 20
        converter.Options.MarginLeft = 20
        converter.Options.MarginRight = 20

        Dim html As String = "<html><body><h1>Custom Page Settings</h1></body></html>"
        Dim doc As PdfDocument = converter.ConvertHtmlString(html)
        doc.Save("custom-settings.pdf")
        doc.Close()

        Console.WriteLine("PDF with custom settings created")
    End Sub
End Module

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;
        
        string html = "<html><body><h1>Custom Page Settings</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("custom-settings.pdf");
        
        Console.WriteLine("PDF with custom settings created");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;
        
        string html = "<html><body><h1>Custom Page Settings</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("custom-settings.pdf");
        
        Console.WriteLine("PDF with custom settings created");
    }
}

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Engines.Chrome
Imports System

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()

        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20
        renderer.RenderingOptions.MarginLeft = 20
        renderer.RenderingOptions.MarginRight = 20

        Dim html As String = "<html><body><h1>Custom Page Settings</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("custom-settings.pdf")

        Console.WriteLine("PDF with custom settings created")
    End Sub
End Module

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Engines.Chrome
Imports System

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()

        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20
        renderer.RenderingOptions.MarginLeft = 20
        renderer.RenderingOptions.MarginRight = 20

        Dim html As String = "<html><body><h1>Custom Page Settings</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("custom-settings.pdf")

        Console.WriteLine("PDF with custom settings created")
    End Sub
End Module

Das Muster der Seiteneinstellungen ist nahezu identisch, mit einfachen Änderungen der Eigenschaftsnamen:

converter.Options.PdfPageSize → renderer.RenderingOptions.PaperSize
converter.Options.PdfPageOrientation → renderer.RenderingOptions.PaperOrientation
PdfPageSize.A4 → PdfPaperSize.A4
PdfPageOrientation.Portrait → PdfPaperOrientation.Portrait

Die Randeigenschaften behalten dieselben Namen und Einheiten bei.

Das Nur-Windows-Problem

Einschränkung der Plattform von SelectPdf

Ungeachtet jeglicher Marketingaussagen unterstützt SelectPdfausdrücklich Folgendes nicht:

Linux (jede Distribution)
macOS
Docker-Container
Azure Functions
AWS Lambda
Google Cloud-Funktionen
Alle ARM-basierten Systeme

Dies ist eine grundlegende architektonische Einschränkung - SelectPdfhängt von Windows-spezifischen Bibliotheken ab und kann nicht portiert werden.

Vergleich der Plattformunterstützung

| Plattform| SelectPdf|IronPDF| | ---------- | :---: | :---: | | Windows Server 2019+| ✅| ✅| | Windows 10/11| ✅| ✅| | Ubuntu 20.04+| ❌| ✅| | Debian 10+| ❌| ✅| | CentOS 7+| ❌| ✅| | Alpen-Linux| ❌| ✅| | Amazon Linux 2| ❌| ✅| | macOS 10.15+| ❌| ✅| | Azure App Service (Linux)| ❌| ✅| | Azure Functions| ❌| ✅| | AWS Lambda| ❌| ✅| | Docker (Linux)| ❌| ✅| | Kubernetes| ❌| ✅|

Die veraltete Rendering-Engine

CSS-Funktionsunterstützung im Vergleich

SelectPdf liefert drei Engines (laut Anbieterdokumentation): ein internes WebKit (Standard), Blink (eingeführt in v19.1, gebündelt mit Chromium 124.0.6367.201 — veröffentlicht im April 2024) und Chromium/CEF. Die Standard-WebKit-Engine hat nicht mit den modernen Webstandards Schritt gehalten:

| CSS-Funktion| SelectPdf(WebKit-Standard) | SelectPdf(Blink, Chromium 124) |IronPDF| |-------------|----------------------------|----------------------------------|---------| | CSS-Raster| ⚠ Teilweise/fehlerhaft | ✅| ✅Vollständig| | Flexbox (grundlegend)| ✅| ✅| ✅| | Flexbox (Gap-Eigenschaft)| ❌| ✅| ✅| | CSS-Variablen| ❌| ✅| ✅| | CSS calc()|⚠ Eingeschränkt| ✅| ✅| | @media print|⚠ Eingeschränkt| ✅| ✅| | @font-face|⚠ Eingeschränkt| ✅| ✅| | Web-Schriftarten|⚠ Eingeschränkt| ✅| ✅| | SVG| ⚠ Grundlegend | ✅| ✅Vollständig| | CSS-Transformationen|⚠ Eingeschränkt| ✅| ✅| | CSS-Animationen| ❌| ⚠ Teilweise | ✅|

Neue Funktionen nach der Migration

Nach der Umstellung auf IronPDF erhalten Sie Funktionen, die SelectPdfnicht bieten kann:

Plattformübergreifende Bereitstellung

// ✅IronPDF- Works everywhere
using IronPdf;

// Azure App Service (Linux)- WORKS
// Docker container - WORKS
// AWS Lambda- WORKS
// GitHub Actions on ubuntu-latest - WORKS
// macOS development - WORKS

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>");
pdf.SaveAs("output.pdf");

// ✅IronPDF- Works everywhere
using IronPdf;

// Azure App Service (Linux)- WORKS
// Docker container - WORKS
// AWS Lambda- WORKS
// GitHub Actions on ubuntu-latest - WORKS
// macOS development - WORKS

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf

' Azure App Service (Linux)- WORKS
' Docker container - WORKS
' AWS Lambda- WORKS
' GitHub Actions on ubuntu-latest - WORKS
' macOS development - WORKS

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>")
pdf.SaveAs("output.pdf")

Imports IronPdf

' Azure App Service (Linux)- WORKS
' Docker container - WORKS
' AWS Lambda- WORKS
' GitHub Actions on ubuntu-latest - WORKS
' macOS development - WORKS

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>")
pdf.SaveAs("output.pdf")

Moderne CSS-Unterstützung

// ✅IronPDF- Uses latest stable Chromium
var renderer = new ChromePdfRenderer();

var html = @"
<style>
    :root { --primary: #007bff; --gap: 20px; }
    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: var(--gap); }
</style>
<div class='grid'>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 1</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 2</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 3</div>
</div>";

var pdf = renderer.RenderHtmlAsPdf(html);
// All modern CSS features render correctly!

// ✅IronPDF- Uses latest stable Chromium
var renderer = new ChromePdfRenderer();

var html = @"
<style>
    :root { --primary: #007bff; --gap: 20px; }
    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: var(--gap); }
</style>
<div class='grid'>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 1</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 2</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 3</div>
</div>";

var pdf = renderer.RenderHtmlAsPdf(html);
// All modern CSS features render correctly!

Imports IronPdf

' ✅IronPDF- Uses latest stable Chromium
Dim renderer As New ChromePdfRenderer()

Dim html As String = "
<style>
    :root { --primary: #007bff; --gap: 20px; }
    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: var(--gap); }
</style>
<div class='grid'>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 1</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 2</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 3</div>
</div>"

Dim pdf = renderer.RenderHtmlAsPdf(html)
' All modern CSS features render correctly!

Imports IronPdf

' ✅IronPDF- Uses latest stable Chromium
Dim renderer As New ChromePdfRenderer()

Dim html As String = "
<style>
    :root { --primary: #007bff; --gap: 20px; }
    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: var(--gap); }
</style>
<div class='grid'>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 1</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 2</div>
    <div style='background: var(--primary); color: white; padding: 1rem;'>Item 3</div>
</div>"

Dim pdf = renderer.RenderHtmlAsPdf(html)
' All modern CSS features render correctly!

Kein Close() erforderlich

IronPDF verwaltet die Ressourcen automatisch:

// Option 1: Let garbage collection handle it
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// No Close() needed

// Option 2: Explicit disposal
using (var pdf = renderer.RenderHtmlAsPdf(html))
{
    pdf.SaveAs("output.pdf");
}

// Option 1: Let garbage collection handle it
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// No Close() needed

// Option 2: Explicit disposal
using (var pdf = renderer.RenderHtmlAsPdf(html))
{
    pdf.SaveAs("output.pdf");
}

' Option 1: Let garbage collection handle it
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
' No Close() needed

' Option 2: Explicit disposal
Using pdf = renderer.RenderHtmlAsPdf(html)
    pdf.SaveAs("output.pdf")
End Using

' Option 1: Let garbage collection handle it
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
' No Close() needed

' Option 2: Explicit disposal
Using pdf = renderer.RenderHtmlAsPdf(html)
    pdf.SaveAs("output.pdf")
End Using

Migrations-Checkliste

Vor der Migration

Alle SelectPdf-Verwendungen im Quellcode prüfen
Dokumentieren Sie die aktuellen Konverteroptionen für die Zuordnung
Header-/Footer-Implementierungen identifizieren
Überprüfen Sie die Seitennummer-Platzhalter-Syntax ({page_number} → {page})
Beachten Sie die grundlegenden URL-Verarbeitungsmuster
Zielbereitstellungsplattformen überprüfen
Den IronPDF Lizenzschlüssel erhalten Sie unter IronPDF

Code-Aktualisierungen

Entfernen Sie das NuGet-Paket Select.HtmlToPdf
Installieren Sie das NuGet-Paket IronPdf
Aktualisieren Sie die Namespace-Importe (using SelectPdf; → using IronPdf;)
Ersetzen Sie HtmlToPdf durch ChromePdfRenderer
Ersetzen Sie ConvertHtmlString() durch RenderHtmlAsPdf()
Ersetzen Sie ConvertUrl() durch RenderUrlAsPdf()
Aktualisieren Sie die Eigenschaftsnamen der Optionen (Options.PdfPageSize → RenderingOptions.PaperSize)
Konvertieren Sie PdfPageSize in PdfPaperSize
Konvertieren Sie PdfPageOrientation in PdfPaperOrientation
Ersetzen Sie doc.Save() durch pdf.SaveAs()
Entfernen Sie alle doc.Close()-Aufrufe
Korrigieren Sie die Seitennummer-Platzhalter ({page_number} → {page}, {total_pages} → {total-pages})
Lizenzinitialisierung beim Anwendungsstart hinzufügen

Nach der Migration

Alle Unit-Tests ausführen
CSS-Rendering überprüfen (insbesondere Grid/Flexbox)
JavaScript -Ausführung testen
Überprüfen Sie die Seitenzahlen in Kopf- und Fußzeile.
Test auf den Zielplattformen (Linux, Docker usw.)
Leistungstest
Vergleich der PDF-Ausgabequalität
CI/CD-Pipelines aktualisieren
Testen von Cloud-Bereitstellungen (falls zutreffend)

Please note: SelectPDF ist ein eingetragenes Markenzeichen seines jeweiligen Eigentümers. Diese Website ist nicht mit Outside Software SRL oder SelectPdfverbunden, unterstützt oder wird von ihnen gesponsert. Alle Produktnamen, Logos und Marken sind Eigentum ihrer jeweiligen Eigentümer. Vergleiche dienen nur zu Informationszwecken und spiegeln öffentlich zugängliche Informationen zum Zeitpunkt des Schreibens wider.

Curtis Chau

Chat with engineering team now

Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...