Sparkline in Bild und HTML konvertieren in Aspose.Cells for .NET

Einführung

Sparklines sind eine kompakte Möglichkeit, Trends direkt innerhalb eines Arbeitsblatts zu visualisieren. Während Excel-Benutzer sie an Ort und Stelle sehen, erfordern viele reale Szenarien, dass eine Sparkline die Zelle verlässt – beispielsweise um als statisches Bild in eine andere Zelle eingebettet, an eine automatisierte E-Mail angehängt oder als Teil eines im Web veröffentlichten HTML-Berichts gerendert zu werden.

Aspose.Cells unterstützt beide dieser Operationen. Die Methode Sparkline.ToImage rendert eine einzelne Sparkline in einen Stream, und die resultierenden Bytes können Cell.EmbeddedImage zugewiesen werden, sodass das Bild innerhalb einer einzelnen Zelle der Arbeitsmappe gespeichert wird. Separat ermöglicht es HtmlSaveOptions, die gesamte Arbeitsmappe – einschließlich der Sparklines – in eine in sich geschlossene HTML-Datei zu konvertieren. Dieser Artikel führt Sie Schritt für Schritt durch beide Workflows.

Workflow 1 — Sparklines als Bilder rendern und in Zellen einbetten

In diesem Workflow erstellen Sie ein Arbeitsblatt, das einen kleinen Bereich mit Quellwerten enthält, hängen drei verschiedene Sparkline-Gruppen (Linie, Säule und Gestapelt/Gewinn-Verlust) an diesen Bereich an, rendern jede Gruppe als PNG und schreiben diese PNG-Bytes in benachbarte Zellen als eingebettete Bilder. Das Endergebnis ist eine einzelne .xlsx-Datei, die sowohl die Live-Sparklines als auch ihre gerenderten Bildgegenstücke enthält.

Schritt-für-Schritt-Anleitung

  1. Definieren Sie ein Arbeitsverzeichnis und stellen Sie sicher, dass es auf der Festplatte vorhanden ist.
  2. Erstellen Sie eine neue Workbook und holen Sie sich eine Referenz auf das erste Worksheet.
  3. Befüllen Sie die Zellen A1 bis E1 mit fünf numerischen Beispielwerten (z. B. tägliche Verkaufszahlen oder Temperaturmessungen).
  4. Fügen Sie dem Arbeitsblatt drei SparklineGroup-Objekte hinzu, indem Sie worksheet.SparklineGroups.Add(...) aufrufen:
    • Eine SparklineType.Line-Gruppe verankert bei F1, mit Datenbereich A1:E1.
    • Eine SparklineType.Column-Gruppe verankert bei G1, mit Datenbereich A1:E1.
    • Eine SparklineType.Stacked-Gruppe (Gewinn/Verlust) verankert bei H1, mit Datenbereich A1:E1.
  5. Erstellen Sie eine Instanz von ImageOrPrintOptions und setzen Sie deren ImageType auf ImageType.Png, damit jede Sparkline als transparentes PNG gerendert wird.
  6. Rendern Sie für jede der drei Gruppen deren einzelne Sparkline mit group.Sparklines[0].ToImage(memoryStream, imageOptions), konvertieren Sie den MemoryStream in ein byte[], und weisen Sie das Array jeweils worksheet.Cells["F2"].EmbeddedImage, worksheet.Cells["G2"].EmbeddedImage und worksheet.Cells["H2"].EmbeddedImage zu.
  7. Speichern Sie die Arbeitsmappe als output_with_sparklines.xlsx.
using System;
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Charts;
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;

// Erstellen Sie eine neue Arbeitsmappe und greifen Sie auf das erste Arbeitsblatt zu
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// Beispieldaten in die Zellen A1:E1 einfügen
worksheet.Cells["A1"].PutValue(5);
worksheet.Cells["B1"].PutValue(-3);
worksheet.Cells["C1"].PutValue(8);
worksheet.Cells["D1"].PutValue(-2);
worksheet.Cells["E1"].PutValue(6);

// Fügen Sie eine Linien-Sparkline-Gruppe hinzu, die an F1 verankert ist (Spalte 5, Zeile 0)
CellArea lineArea = new CellArea();
lineArea.StartColumn = 5;
lineArea.EndColumn = 5;
lineArea.StartRow = 0;
lineArea.EndRow = 0;
int lineIdx = worksheet.SparklineGroups.Add(SparklineType.Line, "A1:E1", false, lineArea);

// Fügen Sie eine Säulen-Sparkline-Gruppe hinzu, die an G1 verankert ist (Spalte 6, Zeile 0)
CellArea columnArea = new CellArea();
columnArea.StartColumn = 6;
columnArea.EndColumn = 6;
columnArea.StartRow = 0;
columnArea.EndRow = 0;
int columnIdx = worksheet.SparklineGroups.Add(SparklineType.Column, "A1:E1", false, columnArea);

// Fügen Sie eine Win/Loss (Gestapelte) Sparkline-Gruppe hinzu, die an H1 verankert ist (Spalte 7, Zeile 0)
CellArea stackedArea = new CellArea();
stackedArea.StartColumn = 7;
stackedArea.EndColumn = 7;
stackedArea.StartRow = 0;
stackedArea.EndRow = 0;
int stackedIdx = worksheet.SparklineGroups.Add(SparklineType.Stacked, "A1:E1", false, stackedArea);

// Bildoptionen für die PNG-Ausgabe konfigurieren
ImageOrPrintOptions imageOptions = new ImageOrPrintOptions();
imageOptions.ImageType = ImageType.Png;

// Konvertieren Sie die Linien-Sparkline in ein Bild und betten Sie es in die Zelle F2 ein
Sparkline lineSp = worksheet.SparklineGroups[lineIdx].Sparklines[0];
using (MemoryStream ms = new MemoryStream())
{
    lineSp.ToImage(ms, imageOptions);
    worksheet.Cells["F2"].EmbeddedImage = ms.ToArray();
}

// Konvertieren Sie die Säulen-Sparkline in ein Bild und betten Sie es in die Zelle G2 ein
Sparkline columnSp = worksheet.SparklineGroups[columnIdx].Sparklines[0];
using (MemoryStream ms = new MemoryStream())
{
    columnSp.ToImage(ms, imageOptions);
    worksheet.Cells["G2"].EmbeddedImage = ms.ToArray();
}

// Konvertieren Sie die Win/Loss-Sparkline in ein Bild und betten Sie es in die Zelle H2 ein
Sparkline stackedSp = worksheet.SparklineGroups[stackedIdx].Sparklines[0];
using (MemoryStream ms = new MemoryStream())
{
    stackedSp.ToImage(ms, imageOptions);
    worksheet.Cells["H2"].EmbeddedImage = ms.ToArray();
}

// Speichern Sie die Arbeitsmappe auf der Festplatte
workbook.Save("output_with_sparklines.xlsx");

Der obige Code erzeugt eine Arbeitsmappe, in der jede visuelle Darstellung einer Sparkline in zwei Formen dupliziert wird: die native Live-Sparkline verankert in Zeile 1 und ein statisches PNG-Bild, das direkt in eine benachbarte Zelle in Zeile 2 eingebettet ist. Da die Bilder innerhalb der Datei selbst leben, bleibt die Arbeitsmappe ein einzelnes in sich geschlossenes Artefakt, das per E-Mail versendet oder archiviert werden kann, ohne dass die eingebetteten Bildreferenzen verloren gehen. Rendern Sie jede Sparkline-Gruppe als PNG, konvertieren Sie den MemoryStream in ein byte[], und weisen Sie das Array der Eigenschaft EmbeddedImage der Zielzelle zu – die Zuweisung ist das, was das Bild zum gespeicherten Inhalt der Zelle macht.

Workflow 2 — Sparkline-Arbeitsblatt nach HTML exportieren

Sobald die Arbeitsmappe Live-Sparklines (und optional eingebettete Bildgegenstücke) enthält, kann das gesamte Arbeitsblatt im Web veröffentlicht werden, indem es als HTML gespeichert wird. Die Klasse HtmlSaveOptions bietet die Einstellungen, die Sie zur Steuerung dieses Exports benötigen; in diesem Workflow verwenden Sie die in Workflow 1 erzeugte Datei output_with_sparklines.xlsx wieder und konvertieren sie in ein sauberes, einseitiges HTML-Dokument.

Schritt-für-Schritt-Anleitung

  1. Stellen Sie sicher, dass die in Workflow 1 erzeugte Datei output_with_sparklines.xlsx auf der Festplatte in Ihrem Arbeitsverzeichnis verfügbar ist.
  2. Laden Sie diese Datei in eine neue Workbook-Instanz.
  3. Instanziieren Sie HtmlSaveOptions und setzen Sie deren Eigenschaft ExportActiveWorksheetOnly auf true, sodass die resultierende HTML-Datei nur das aktive Arbeitsblatt und nicht die gesamte Arbeitsmappe enthält.
  4. Rufen Sie workbook.Save("sparklines.html", htmlOptions) auf, um die HTML-Ausgabe auf die Festplatte zu schreiben.
using System;
using System.IO;
using Aspose.Cells;

Workbook workbook = new Workbook("output_with_sparklines.xlsx");
HtmlSaveOptions htmlOptions = new HtmlSaveOptions();
htmlOptions.ExportActiveWorksheetOnly = true;
workbook.Save("sparklines.html", htmlOptions);

Der obige Code nimmt die sparkline-reiche Arbeitsmappe aus Workflow 1 und verwandelt sie in eine portable HTML-Datei. Sparklines werden je nach Exportmodus als Inline-SVG- oder PNG-Renderings innerhalb des generierten HTML beibehalten, sodass Endbenutzer die Trends in jedem modernen Browser anzeigen können, ohne Excel installiert zu haben. Durch das Setzen von ExportActiveWorksheetOnly auf true vermeiden Sie es, versehentlich versteckte Blätter oder zusätzliche Daten zu veröffentlichen – es wird nur das aktuell für den Benutzer sichtbare Arbeitsblatt exportiert.

API-Zusammenfassung

Die obigen Workflows basieren auf einem kleinen Satz von Aspose.Cells-APIs, die zusammenarbeiten.

  • SparklineGroup und der Sammlungs-Accessor worksheet.SparklineGroups werden verwendet, um den Typ (Linie, Säule, Gestapelt), den Datenbereich und die Ankerzelle für jede Sparkline-Gruppe zu deklarieren. In diesem Artikel ist jede Gruppe an einer einzelnen Zelle verankert, sodass die Gruppe über worksheet.SparklineGroups[i] erreicht wird.
  • Sparkline und der Indexer group.Sparklines[0] geben die einzelne Sparkline innerhalb einer Gruppe zurück. Da jede Gruppe im Beispiel genau eine Sparkline enthält, ist keine foreach-Schleife erforderlich.
  • Sparkline.ToImage(Stream, ImageOrPrintOptions) ist die Rendering-Methode, die ein Bild der Sparkline in einen bereitgestellten Stream schreibt. Die Methode gibt void zurück; Sie lesen die Bytes nach dem Aufruf aus dem Stream.
  • Cell.EmbeddedImage ist eine byte[]-Eigenschaft, die ein Bild innerhalb einer einzelnen Zelle speichert. Sie ist in Aspose.Cells 26.5 und höher verfügbar und ist die empfohlene Methode, um eine mit ToImage gerenderte Sparkline in dieselbe Arbeitsmappe zurückzuführen.
  • HtmlSaveOptions.ExportActiveWorksheetOnly (ein bool) beschränkt den HTML-Export auf das aktive Arbeitsblatt. Es ist eine der am häufigsten verwendeten Eigenschaften von HtmlSaveOptions, wenn einseitige Berichte erzeugt werden.
  • ImageOrPrintOptions.ImageType befindet sich im Namespace Aspose.Cells.Drawing und wählt das Bildformat (zum Beispiel ImageType.Png), das beim Rendern mit ToImage und beim Drucken von Arbeitsblättern als Bilder verwendet wird.

Verwandte Artikel

Verwenden von Sparklines und Einstellungen 3D Format Sparkline kopieren durch Festlegen des Datenbereichs und des Speicherorts der Sparkline Gruppe