Das Erzeugen visueller Vorschauen von Tabellendaten ist ein häufiges Erfordernis beim Erstellen von Reporting‑Dashboards oder E‑Mail‑Zusammenfassungen. Conholdate.Total for Java bietet ein robustes SDK, das den Prozess der Konvertierung von Excel zu Bild in Java‑Anwendungen vereinfacht. In diesem Leitfaden sehen Sie, wie Sie eine XLSX‑Arbeitsmappe laden, die PNG‑Ausgabe konfigurieren und Bilddateien für gesamte Arbeitsblätter, Diagramme oder bestimmte Bereiche erzeugen. Am Ende haben Sie ein sofort einsatzbereites Code‑Beispiel, das Sie an Ihre eigenen Projekte anpassen können.

Was Convert Excel Files to Image von Ihrer Anwendung verlangt

Entwickler müssen häufig Tabelleninhalte in statische Bilder für Webvorschauen, PDF-Berichte oder mobile Miniaturansichten umwandeln. Die Anforderung umfasst typischerweise das Beibehalten der Zelle-Formatierung, das Rendern eingebetteter Diagramme und optional das Beschränken der Konvertierung auf einen einzelnen Bereich. Diese Aufgaben manuell zu erledigen, indem man Excel öffnet, Screenshots macht und sie speichert, skaliert nicht und kann zu inkonsistenten Ergebnissen führen.

Technische Anforderungen für eine zuverlässige Lösung sind: Unterstützung von XLSX-Dateien, die Möglichkeit, Diagramme und Formeln einzubinden, konfigurierbare Bildauflösung und die Stapelverarbeitung mehrerer Arbeitsblätter. Die Konvertierung muss auf einer Server‑ oder Desktop‑Umgebung laufen, ohne dass Microsoft Office erforderlich ist.

Auswahl von Conholdate.Total for Java für den Job

Conholdate.Total for Java bietet eine einheitliche API, die alle benötigten Funktionen abdeckt. Mit seinen ExcelLoadOptions können Sie Diagramme und Formeln laden, während ImageConvertOptions eine feinkörnige Kontrolle über Format, Qualität und Abmessungen bieten. Das SDK funktioniert auf jeder Java‑Runtime, erfordert nur die Maven‑Abhängigkeit und verarbeitet große Arbeitsmappen effizient.

Für die detaillierte API‑Nutzung siehe die offizielle Dokumentation. Die vollständige Referenz für Klassen wie Conversion, ExcelLoadOptions und ImageConvertOptions ist in der API‑Referenz verfügbar. Die neueste Bibliothek können Sie von der Release‑Seite herunterladen.

Implementierung der Excel‑zu‑Bild‑Konvertierung in Java

Der Konvertierungsprozess lässt sich in einige klare Schritte unterteilen. Die folgenden Abschnitte führen Sie durch jeden Teil, wobei kurze Codeauszüge direkt aus dem vollständigen Beispiel übernommen werden.

Installieren Sie Conholdate.Total für Java über Maven

Fügen Sie das Conholdate Maven-Repository und die SDK-Abhängigkeit zu Ihrer pom.xml hinzu:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

Excel-Datei mit Diagramm- und Formelsupport laden

Erstellen Sie eine ExcelLoadOptions-Instanz, aktivieren Sie das Laden von Diagrammen und Formeln und initialisieren Sie das Conversion-Objekt mit einem Dateistream:

ExcelLoadOptions loadOptions = new ExcelLoadOptions();
loadOptions.setLoadCharts(true);
loadOptions.setLoadFormulas(true);

Conversion conversion = new Conversion(new FileInputStream("input.xlsx"), loadOptions);

Bildausgabeoptionen für PNG konfigurieren

Legen Sie das gewünschte Bildformat, die Qualität und die Abmessungen fest. Die Breite ist fest, während die Höhe das Seitenverhältnis beibehält:

ImageConvertOptions imgOptions = new ImageConvertOptions();
imgOptions.setFormat(ImageConvertOptions.ImageFormat.PNG);
imgOptions.setQuality(90);
imgOptions.setWidth(1200);
imgOptions.setHeight(0); // preserve aspect ratio

Jedes Arbeitsblatt oder jeden Bereich in PNG-Bilder konvertieren

Iterieren Sie über die Arbeitsmappenseiten (Blätter) und konvertieren Sie jede einzelne. Sie können auch einen bestimmten Bereich anvisieren, indem Sie die pageNumber anpassen oder zusätzliche Ladeoptionen verwenden:

int pageCount = conversion.getPageCount();
for (int i = 1; i <= pageCount; i++) {
    imgOptions.setPageNumber(i);
    String outputPath = "output_images/sheet_" + i + ".png";
    conversion.convert(outputPath, imgOptions);
}

Ausgabe überprüfen und Ausnahmen behandeln

Umwickeln Sie die Konvertierungslogik in einen try‑catch‑Block und stellen Sie sicher, dass das Ausgabeverzeichnis vor dem Starten existiert:

try {
    Files.createDirectories(Paths.get("output_images"));
    // conversion code here
    System.out.println("Excel to image conversion completed successfully.");
} catch (Exception ex) {
    System.err.println("Conversion failed: " + ex.getMessage());
    ex.printStackTrace();
}

Die obigen Schritte zeigen, wie man Excel in ein Bild konvertieren mit dem Conholdate.Total SDK, wobei Ihnen Flexibilität beim Umgang mit Diagrammen, Bereichen und ganzen Arbeitsblättern geboten wird.

Vollständiges Codebeispiel: Excel in Bild konvertieren mit Vollblattunterstützung

Der folgende Code zeigt die vollständige, sofort einsatzbereite Implementierung, die in den obigen Schritten beschrieben wurde.

import java.io.FileInputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.load.ExcelLoadOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions.ImageFormat;

public class ExcelToImageConverter {
    public static void main(String[] args) {
        String inputFile = "input.xlsx";
        String outputFolder = "output_images";

try {
            // Create output directory if it does not exist
            Files.createDirectories(Paths.get(outputFolder));

// Load options: include charts and formulas during conversion
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            loadOptions.setLoadCharts(true);
            loadOptions.setLoadFormulas(true);

// Initialize conversion with the Excel file and load options
            try (Conversion conversion = new Conversion(new FileInputStream(inputFile), loadOptions)) {

// Determine how many pages (sheets) the workbook has
                int pageCount = conversion.getPageCount();

// Configure image output options
                ImageConvertOptions imgOptions = new ImageConvertOptions();
                imgOptions.setFormat(ImageFormat.PNG);   // Output format
                imgOptions.setQuality(90);               // Quality (relevant for JPEG)
                imgOptions.setWidth(1200);               // Desired width, height will keep aspect ratio
                imgOptions.setHeight(0);                 // 0 means preserve original aspect ratio

// Convert each sheet to a separate image file
                for (int i = 1; i <= pageCount; i++) {
                    imgOptions.setPageNumber(i);
                    String outputPath = outputFolder + "/sheet_" + i + ".png";
                    conversion.convert(outputPath, imgOptions);
                }
            }

System.out.println("Excel to image conversion completed successfully.");
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input.xlsx, output_images) an Ihre tatsächlichen Speicherorte anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten korrekt installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Fazit

Das Konvertieren von Excel zu Bild in Java wird einfach, wenn Sie Conholdate.Total for Java nutzen. Das SDK übernimmt die Diagrammdarstellung, die Formelauswertung und die Ausgabe von hochqualitativen PNGs mit minimalem Code. Wenn Sie der Schritt‑für‑Schritt‑Anleitung folgen, können Sie diese Fähigkeit in Reporting‑Tools, E‑Mail‑Generatoren oder jede Anwendung integrieren, die visuelle Tabellenkalkulationsdarstellungen benötigt. Denken Sie daran, dass Produktionsbereitstellungen eine kommerzielle Lizenz erfordern; Sie können die Preisoptionen auf der Seite Conholdate.Total pricing prüfen und während der Evaluierung eine temporäre Lizenz von der temporäre Lizenzseite erhalten.

Häufig gestellte Fragen

  • Wie kann ich Excel in ein Bild in Java konvertieren?
    Verwenden Sie die Conversion‑Klasse von Conholdate.Total for Java, konfigurieren Sie ExcelLoadOptions und ImageConvertOptions und rufen Sie anschließend convert für jedes Arbeitsblatt auf.

  • Kann ich ein Excel-Diagramm in ein Bild konvertieren?
    Ja. Aktivieren Sie das Laden von Diagrammen mit loadOptions.setLoadCharts(true) und geben Sie die Seitenzahl des Diagramms an, wenn Sie imgOptions.setPageNumber festlegen.

  • Ist es möglich, nur einen bestimmten Zellbereich zu konvertieren?
    Sie können einen Bereich in den Ladeoptionen definieren oder die entsprechende Seitenzahl auswählen, die dem gewünschten Bereich vor der Konvertierung entspricht.

  • Welche Lizenz ist für die Produktion erforderlich?
    Eine kommerzielle Lizenz ist erforderlich. Überprüfen Sie die Kosten auf der Seite Conholdate.Total Preisgestaltung und erhalten Sie eine temporäre Lizenz von der temporären Lizenzseite.

Mehr lesen