1. IronPDF
  2. Anleitungen
  3. Graustufen
Wie man Graustufen-PDF-Dateien in C# erstellt

Graustufen-PDF in C

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF ermöglicht es Ihnen, PDFs in Graustufen darzustellen, indem Sie die Eigenschaft GrayScale auf true in RenderingOptions setzen, wobei Farbinhalt in Grautöne umgewandelt wird, um kostengünstigeres Drucken und verbesserte Lesbarkeit zu erreichen.

Schnellstart: Farb-PDFs mit IronPDF in Graustufen konvertieren

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

  1. Installieren Sie IronPDF mit NuGet Package Manager

    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, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Herunterladen der IronPDF-Bibliothek zum Rendern von Graustufen-PDFs
  2. Instanziierung der Klasse ChromePdfRenderer
  3. Setzen Sie die GrayScale Eigenschaft von RenderingOptions auf true
  4. Zugriff und Rendern eines PDF-Dokuments von einer URL, HTML-Zeichenfolge oder Datei
  5. Exportieren Sie das Graustufen-PDF-Dokument an den gewünschten Ort


Wie generiere ich ein Graustufen-PDF?

Um ein Graustufen-PDF zu erzeugen, setzen Sie die Eigenschaft GrayScale des 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 Code-Snippet 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 wird durch Setzen von GrayScale auf True Farben umgewandelt?

Ein Graustufen-PDF ist ein Dokument, in dem alle Farben und Schattierungen in Graustufen statt im Vollfarbspektrum dargestellt werden. Wenn Sie die Option GrayScale aktivieren, konvertiert IronPDF's Chrome-Rendering-Engine automatisch alle RGB-Farbwerte in ihre entsprechenden Graustufenäquivalente unter Verwendung von branchenüblichen Leuchtdichteberechnungen. 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, wodurch 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");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Set GrayScale to true
renderer.RenderingOptions.GrayScale = True

Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://ironsoftware.com/")
pdf.CopyPage(0).SaveAs("test.pdf")
$vbLabelText   $csharpLabel
Icon Quote related to Was passiert mit Text bei der Konvertierung in Graustufen?

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic related to Was passiert mit Text bei der Konvertierung in Graustufen?

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen
Icon Quote related to Was passiert mit Text bei der Konvertierung in Graustufen?

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle related to Was passiert mit Text bei der Konvertierung in Graustufen?

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen
Icon Quote related to Was passiert mit Text bei der Konvertierung in Graustufen?

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones related to Was passiert mit Text bei der Konvertierung in Graustufen?

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

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.

:path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-3.cs
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");

Imports IronPdf

' Create a renderer with grayscale enabled
Dim renderer As New ChromePdfRenderer() With {
    .RenderingOptions = New ChromePdfRenderOptions() With {
        .GrayScale = True,
        .MarginTop = 50,
        .MarginBottom = 50,
        .MarginLeft = 20,
        .MarginRight = 20
    }
}

' Render an HTML file to grayscale PDF
Dim 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.

:path=/static-assets/pdf/content-code-examples/how-to/color-grayscale-4.cs
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");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.GrayScale = True

' HTML content with inline CSS
Dim htmlContent As String = "
    <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>"

Dim 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 verschwommen: Verwenden Sie geeignete DPI-Einstellungen in den Renderoptionen
  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
Hairil Hasyimi Bin Omar
  Jetzt mit dem Ingenieurteam chatten
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 19,936,792 | Version: 2026.7 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.