Wie man Graustufen-PDF-Dateien in C# erstellt

Graustufen-PDF in C#

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF ermöglicht es Ihnen, PDFs in Graustufen zu rendern, indem Sie die GrayScale-Eigenschaft in RenderingOptions auf true setzen und so farbige Inhalte in Graustufen konvertieren, um kostengünstig zu drucken und die Lesbarkeit zu verbessern.

als-überschrift:2(Schnellstart: Farbige PDFs mit IronPDF in Graustufen umwandeln)

Mit IronPDF lassen sich farbige PDF-Dateien mit nur wenigen Zeilen Code in Graustufen umwandeln. Setzen Sie die Eigenschaft GrayScale in den RenderingOptions, um Webseiten oder HTML-Inhalte in PDFs mit Graustufen zu rendern. Dieser Leitfaden zeigt Ihnen, wie Sie Graustufendokumente für eine einheitliche Darstellung erzeugen.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    var renderer = new IronPdf.ChromePdfRenderer();
    renderer.RenderingOptions.GrayScale = true;
    var pdf = renderer.RenderUrlAsPdf("https://example.com");
    pdf.SaveAs("grayscale.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer


Wie generiere ich ein Graustufen-PDF?

Um ein Graustufen-PDF zu erzeugen, setzen Sie die Eigenschaft GrayScale der RenderingOptions auf true. Diese Funktion ist Teil der umfassenden Rendering-Optionen von IronPDF, mit denen Sie die PDF-Ausgabe genau steuern können.

Im bereitgestellten Codeschnipsel wird die Graustufenfunktion nach der Instanziierung eines ChromePdfRenderer aktiviert. Anschließend wird eine Webseite mit der Methode RenderUrlAsPdf gerendert. Der Code extrahiert außerdem nur die erste Seite der gerenderten PDF-Datei und speichert sie lokal. Wenn Sie IronPDF noch nicht kennen, sollten Sie sich unseren Schnellstart-Leitfaden ansehen, um sich mit den Grundlagen vertraut zu machen.

Warum konvertiert das Einstellen von Graustufen in True Farben?

Ein Graustufen-PDF ist ein Dokument, in dem alle Farben und Schattierungen in Graustufen statt im Vollfarbspektrum dargestellt werden. Wenn Sie die Graustufenoption aktivieren, konvertiert die Chrome-Rendering-Engine von IronPDF automatisch alle RGB-Farbwerte in ihre entsprechenden Graustufenäquivalente, wobei die branchenüblichen Leuchtdichteberechnungen verwendet werden. Dadurch wird sichergestellt, dass die visuelle Hierarchie und der Kontrast Ihres Originaldokuments erhalten bleiben, während alle Farbinformationen entfernt werden.

Wann sollte ich Graustufen-PDFs verwenden?

IronPDF rendert PDF-Dokumente in Graustufen statt in Farbe. Das Drucken von PDF-Dokumenten in Graustufen ist kosteneffektiv für den Druck großer Mengen. Die Wiedergabe in Graustufen verbessert die Lesbarkeit, wenn die Originalfarben zu hell oder lebhaft sind. Graustufen-PDFs sind besser mit verschiedenen Geräten, Softwareprogrammen und Plattformen kompatibel und gewährleisten ein einheitliches Anzeige- und Druckverhalten.

Häufige Anwendungsfälle für Graustufen-PDFs sind:

  • Geschäftsberichte: Finanzdokumente sehen in Graustufen oft professioneller aus
  • Rechtliche Dokumente: Gerichtsakten und juristische Schriftsätze erfordern in der Regel eine Formatierung in Graustufen
  • Akademische Arbeiten: Forschungsarbeiten und Dissertationen werden in der Regel in Graustufen gedruckt
  • Druck in großen Mengen: Graustufen reduzieren die Kosten beim Druck von Hunderten von Seiten
  • Archivierte Dokumente: Ideal für die langfristige Speicherung und PDF/A-Konformität

Was passiert mit Text bei der Konvertierung in Graustufen?

Die aktuelle Implementierung der Graustufenfunktion wandelt Text im gerenderten PDF-Dokument in ein Bild um, was dazu führt, dass die Methode ExtractAllImages keinen Text ausgibt.

Derzeit ist diese Funktionalität nur beim Rendern von PDFs verfügbar. Zukünftige Aktualisierungen könnten die Möglichkeit beinhalten, bestehende PDF-Dokumente in Graustufen zu konvertieren. Weitere Informationen zur Arbeit mit der Textextraktion finden Sie in unserem Leitfaden Texte und Bilder extrahieren.

:path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-grayscale.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set GrayScale to true
renderer.RenderingOptions.GrayScale = true;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://ironsoftware.com/");
pdf.CopyPage(0).SaveAs("test.pdf");
$vbLabelText   $csharpLabel

Erweiterte Beispiele für die Erstellung von PDF-Dateien in Graustufen

Konvertierung von HTML-Dateien in Graustufen-PDFs

Wenn Sie mit lokalen HTML-Dateien arbeiten, können Sie diese in Graustufen-PDFs umwandeln. Dies ist nützlich, wenn Sie vorgefertigte Vorlagen oder Berichte haben, die ohne Farbe gerendert werden müssen. Erfahren Sie mehr über die Konvertierung von HTML-Dateien in PDF.

using IronPdf;

// Create a renderer with grayscale enabled
var renderer = new ChromePdfRenderer()
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        GrayScale = true,
        MarginTop = 50,
        MarginBottom = 50,
        MarginLeft = 20,
        MarginRight = 20
    }
};

// Render an HTML file to grayscale PDF
var pdf = renderer.RenderHtmlFileAsPdf(@"C:\Reports\MonthlyReport.html");
pdf.SaveAs(@"C:\Reports\MonthlyReport_Grayscale.pdf");
using IronPdf;

// Create a renderer with grayscale enabled
var renderer = new ChromePdfRenderer()
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        GrayScale = true,
        MarginTop = 50,
        MarginBottom = 50,
        MarginLeft = 20,
        MarginRight = 20
    }
};

// Render an HTML file to grayscale PDF
var pdf = renderer.RenderHtmlFileAsPdf(@"C:\Reports\MonthlyReport.html");
pdf.SaveAs(@"C:\Reports\MonthlyReport_Grayscale.pdf");
$vbLabelText   $csharpLabel

Erstellen von Graustufen-PDFs aus HTML-Strings

Für die Generierung dynamischer Inhalte konvertieren Sie HTML-Strings direkt in PDF-Dateien mit Graustufen. Dieser Ansatz eignet sich gut für die Erstellung von Rechnungen, Quittungen oder anderen Dokumenten, deren Inhalt programmatisch erstellt wird. Weitere Einzelheiten finden Sie in unserem Leitfaden zur Konvertierung von HTML-Strings in PDF.

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;

// HTML content with inline CSS
string htmlContent = @"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; }
            .header { background-color: #4CAF50; color: white; padding: 20px; }
            .content { padding: 20px; }
            .highlight { background-color: #ffeb3b; padding: 5px; }
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #12345</h1>
        </div>
        <div class='content'>
            <p>This colorful invoice will be rendered in grayscale.</p>
            <p class='highlight'>Highlighted sections maintain contrast in grayscale.</p>
        </div>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice_grayscale.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.GrayScale = true;

// HTML content with inline CSS
string htmlContent = @"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; }
            .header { background-color: #4CAF50; color: white; padding: 20px; }
            .content { padding: 20px; }
            .highlight { background-color: #ffeb3b; padding: 5px; }
        </style>
    </head>
    <body>
        <div class='header'>
            <h1>Invoice #12345</h1>
        </div>
        <div class='content'>
            <p>This colorful invoice will be rendered in grayscale.</p>
            <p class='highlight'>Highlighted sections maintain contrast in grayscale.</p>
        </div>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice_grayscale.pdf");
$vbLabelText   $csharpLabel

Erwägungen zur Leistung

Bei der Erstellung von Graustufen-PDFs sollten Sie diese Leistungsfaktoren berücksichtigen:

  1. Dateigröße: Graustufen-PDFs sind kleiner als Farbversionen, ideal für E-Mail-Anhänge und Web-Downloads
  2. Rendering-Geschwindigkeit: Die Graustufen-Konvertierung erhöht die Rendering-Zeit nur minimal
  3. Speicherkapazität: Graustufen-Rendering verbraucht weniger Speicher als Vollfarb-Rendering, was bei großen Dokumenten von Vorteil ist

Für eine bessere Leistung bei der Erstellung mehrerer Graustufen-PDFs sollten Sie async- und Multithreading-Techniken verwenden.

Integration mit anderen IronPDF-Funktionen

Kombinieren Sie Graustufen-PDFs mit anderen IronPDF-Funktionen für eine umfassende Dokumentenverarbeitung:

  • Kopf- und Fußzeilen: Fügen Sie Ihren Graustufendokumenten professionelle Kopf- und Fußzeilen hinzu, indem Sie unsere Anleitung für Kopf- und Fußzeilen verwenden
  • Seitenzahlen: Fügen Sie Seitenzahlen in Ihre Graustufen-PDFs ein, indem Sie unser Seitenzahlen-Tutorial befolgen
  • Wasserzeichen: Anbringen von Wasserzeichen in Graustufen-PDFs für Branding oder Sicherheit
  • PDF-Komprimierung: Verringern Sie die Dateigröße durch die Kombination von Graustufen-Rendering und PDF-Komprimierung weiter

Best Practices für die Erstellung von PDF-Dateien in Graustufen

  1. Test Farbkontrast: Stellen Sie vor der Konvertierung einen ausreichenden Kontrast zwischen den Elementen sicher
  2. Verwenden Sie semantisches HTML: Gut strukturiertes HTML führt zu besseren Ergebnissen bei der Konvertierung in Graustufen
  3. Berücksichtigen Sie Barrierefreiheit: PDF-Dateien in Graustufen können die Lesbarkeit für manche Sehbehinderungen verbessern
  4. Vorprüfung vor der Produktion: Prüfen Sie die Graustufenausgabe immer in der Vorschau, bevor Sie große Stapel erstellen

Behebung häufiger Probleme

Wenn Sie Probleme mit der PDF-Graustufengenerierung haben:

  1. Text erscheint unscharf: Verwenden Sie geeignete DPI-Einstellungen in Ihren Rendering-Optionen
  2. Bilder sehen verwaschen aus: Quellbildkontrast vor der Konvertierung anpassen
  3. Leistungsprobleme: Implementierung einer Zwischenspeicherung für häufig generierte Graustufen-PDFs

Ausführliche Informationen zur Fehlerbehebung finden Sie in unserer umfassenden Anleitung zur Fehlerbehebung.

Bereit zu sehen, was Sie sonst noch tun können? Schauen Sie sich unsere Tutorial-Seite hier an: PDFs konvertieren

Häufig gestellte Fragen

Wie konvertiere ich in C# eine farbige PDF-Datei in Graustufen?

Um ein Farb-PDF mit IronPDF in Graustufen zu konvertieren, instanziieren Sie ein ChromePdfRenderer-Objekt und setzen Sie die Eigenschaft GrayScale in RenderingOptions auf true. Verwenden Sie dann Methoden wie RenderUrlAsPdf, RenderHtmlAsPdf oder RenderHtmlFileAsPdf, um Ihr Graustufen-PDF-Dokument zu erzeugen.

Was ist der Zweck der Eigenschaft GrayScale in RenderingOptions?

Die Eigenschaft GrayScale in den RenderingOptions von IronPDF konvertiert alle Farben in Ihrer PDF-Datei in Grautöne. Wenn sie auf true gesetzt ist, berechnet die Chrome-Rendering-Engine von IronPDF automatisch die Luminanzwerte von RGB-Farben und konvertiert sie in ihre Graustufenäquivalente, wobei die visuelle Hierarchie und der Kontrast erhalten bleiben.

Warum sollte ich Graustufen-PDFs anstelle von Farb-PDFs verwenden?

Das Graustufen-Rendering von IronPDF ist ideal für den kosteneffizienten Druck, insbesondere bei großen Stapelverarbeitungen. Graustufen-PDFs verbessern auch die Lesbarkeit, wenn die Originalfarben zu hell sind, sorgen für eine bessere Kompatibilität zwischen verschiedenen Geräten und Plattformen und bieten ein konsistentes Anzeigeerlebnis.

Kann ich bestimmte Seiten in Graustufen umwandeln und andere in Farbe belassen?

Mit IronPDF können Sie Dokumente in Graustufen rendern und dann bestimmte Seiten mit Methoden wie CopyPage extrahieren. Während das gesamte Dokument in Graustufen gerendert wird, wenn die Eigenschaft GrayScale aktiviert ist, können Sie verschiedene Rendering-Durchläufe kombinieren, um gemischte Farb- und Graustufendokumente zu erstellen.

Welche Arten von Inhalten können in Graustufen-PDFs konvertiert werden?

IronPDF kann verschiedene Inhaltstypen in Graustufen-PDFs konvertieren, darunter Webseiten über RenderUrlAsPdf, HTML-Strings über RenderHtmlAsPdf und HTML-Dateien mit RenderHtmlFileAsPdf. Alle Inhaltstypen unterstützen die gleiche Graustufen-Rendering-Option für einheitliche Ergebnisse.

Hairil Hasyimi Bin Omar
Software Ingenieur
Wie alle großen Ingenieure ist Hairil ein leidenschaftlicher Lerner. Er verfeinert sein Wissen in C#, Python und Java, um Iron Software-Teammitgliedern Mehrwert zu bieten. Hairil kam von der Universiti Teknologi MARA in Malaysia, wo er seinen Bachelor in Chemie- und Verfahrenstechnik abschloss.
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht