Gestionar libros de trabajo de gráficos en presentaciones en .NET
Visión general
Este artículo explica cómo trabajar con libros de trabajo de gráficos en Aspose.Slides. Muestra cómo leer y escribir datos de gráficos a través de flujos de libros de trabajo, usar celdas del libro de trabajo como etiquetas de datos del gráfico, acceder a colecciones de hojas de cálculo y especificar el tipo de origen de datos para los valores del gráfico.
También cubre el trabajo con libros de trabajo externos como orígenes de datos del gráfico. Los ejemplos demuestran cómo crear y asignar un libro de trabajo externo, obtener la ruta de un libro de trabajo externo vinculado a un gráfico y editar los datos del gráfico cuando el libro de trabajo está disponible.
Para las celdas del libro de trabajo que representan datos ausentes, consulte Controlar la visualización de celdas vacías para conocer la diferencia entre una celda vacía y cero, y una comparación de gráfico de líneas de los modos de visualización disponibles.
Incluir datos de filas y columnas ocultas
Utilice IChart.PlotVisibleCellsOnly para controlar si un gráfico traza datos de filas y columnas ocultas de la hoja de cálculo. Establézcalo en true para trazar solo celdas visibles, o en false para incluir tanto celdas visibles como ocultas. Esta configuración controla el trazado del gráfico; no oculta ni muestra filas o columnas de la hoja de cálculo.
La presentación de ejemplo contiene un gráfico de columnas como la primera forma de su primera diapositiva. La hoja de cálculo incrustada, Sheet1, contiene el rango de origen siguiente, A1:C4. La fila 3 y la columna C están ocultas, pero sus celdas siguen conteniendo valores.
| Fila de hoja | A: Mes | B: Minorista | C: Mayorista (columna oculta) |
|---|---|---|---|
| 2 | Enero | 10 | 30 |
| 3 (fila oculta) | Febrero | 40 | 60 |
| 4 | Marzo | 20 | 50 |
Acceda a las celdas de origen a través de IChartData.ChartDataWorkbook y lea IChartDataCell.IsHidden para inspeccionar su estado de ocultación. Esta propiedad es de solo lectura. En este archivo, B2 es visible, B3 pertenece a la fila oculta y C2 pertenece a la columna oculta; el ejemplo imprime False, True y True, respectivamente.
Para este ejemplo, actualice los datos del gráfico tras cambiar la configuración de trazado: conserve el libro de trabajo incrustado con ReadWorkbookStream y recárguelo con WriteWorkbookStream. Cuando se incluyen todas las celdas, use también SetRange para restaurar el rango completo, incluida la categoría oculta de febrero. Simplemente cambiar la bandera no es suficiente para actualizar los datos en caché del gráfico y las etiquetas de categoría de esta muestra.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation("hidden-source-data.pptx");
var slide = presentation.Slides[0];
if (slide.Shapes[0] is IChart chart)
{
var workbook = chart.ChartData.ChartDataWorkbook;
Console.WriteLine($"B2 hidden: {workbook.GetCell(0, "B2").IsHidden}");
Console.WriteLine($"B3 hidden: {workbook.GetCell(0, "B3").IsHidden}");
Console.WriteLine($"C2 hidden: {workbook.GetCell(0, "C2").IsHidden}");
using var workbookStream = chart.ChartData.ReadWorkbookStream();
foreach (var visibleOnly in new[] { true, false })
{
chart.PlotVisibleCellsOnly = visibleOnly;
// Actualizar los datos del gráfico desde el libro de trabajo incrustado.
workbookStream.Position = 0;
chart.ChartData.WriteWorkbookStream(workbookStream);
if (!visibleOnly)
{
// Restaurar el rango de origen completo, incluidas las categorías ocultas.
chart.ChartData.SetRange("Sheet1!$A$1:$C$4");
}
presentation.Save($"hidden_cells_{visibleOnly}.pptx", SaveFormat.Pptx);
}
}
else
{
Console.WriteLine("The first shape is not a chart.");
}
El ejemplo guarda dos versiones de la presentación: una con solo los valores minoristas visibles (10 y 20) y otra con los seis valores. Las imágenes a continuación se generaron a partir de las presentaciones guardadas después de volver a abrirlas; ambos archivos conservan la configuración de trazado asignada. La fila 3 y la columna C siguen ocultas en ambos libros de trabajo incrustados.
Solo celdas visibles (true) |
Todas las celdas (false) |
|---|---|
![]() |
![]() |
Una celda oculta que contiene un valor es diferente de una celda vacía. IChart.DisplayBlanksAs controla cómo se visualizan los valores ausentes; no incluye ni excluye datos de origen ocultos. Consulte Controlar la visualización de celdas vacías para un ejemplo.
Obtener el rango de datos de un gráfico
Antes de actualizar los datos del libro de trabajo en una presentación existente, inspeccione los rangos de origen para identificar qué celdas de la hoja de cálculo usa cada gráfico. El método IChartData.GetRange devuelve el rango de datos actual como una fórmula calificada por hoja, como Sheet1!$A$1:$D$5. Aquí, Sheet1 es el nombre de la hoja, ! lo separa del rango de celdas y $A$1:$D$5 identifica las celdas de la A1 a la D5, inclusive. Los signos de dólar indican referencias absolutas de fila y columna.
El método lee el rango actual sin modificar el gráfico ni su libro de trabajo. Si el gráfico no usa un libro de trabajo como origen de datos, lanza una InvalidOperationException. Para más información, consulte la Referencia de la API ChartData.
Este ejemplo abre una presentación y comprueba directamente las formas de cada diapositiva en busca de gráficos. Imprime el nombre y el rango de origen de cada gráfico. Si un gráfico no usa un libro de trabajo, muestra un mensaje y continúa con el siguiente gráfico.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation("presentation.pptx");
foreach (var slide in presentation.Slides)
{
foreach (var shape in slide.Shapes)
{
if (shape is IChart chart)
{
try
{
var range = chart.ChartData.GetRange();
Console.WriteLine($"{chart.Name}: {range}");
}
catch (InvalidOperationException)
{
Console.WriteLine($"{chart.Name}: The chart does not use a workbook as its data source.");
}
}
}
}
Leer y escribir datos de un gráfico desde un libro de trabajo
Aspose.Slides for .NET proporciona los métodos ReadWorkbookStream y WriteWorkbookStream que le permiten leer y escribir libros de trabajo de datos de gráficos (que contienen datos de gráficos editados con Aspose.Cells). Nota que los datos del gráfico deben organizarse de la misma manera o deben tener una estructura similar a la de origen.
Este ejemplo usa una presentación con un gráfico como la primera forma de su primera diapositiva. Lee el libro de trabajo incrustado a un flujo, elimina las series y categorías existentes, y escribe de nuevo el mismo libro de trabajo. Los cambios permanecen en memoria; el ejemplo no guarda la presentación.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation("chart.pptx");
var slide = presentation.Slides[0];
var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
var chartData = chart.ChartData;
using var workbookStream = chartData.ReadWorkbookStream();
chartData.Series.Clear();
chartData.Categories.Clear();
workbookStream.Position = 0;
chartData.WriteWorkbookStream(workbookStream);
}
else
{
Console.WriteLine("The first shape is not a chart.");
}
Validar el diseño del gráfico tras la modificación del libro de trabajo
Al sustituir un libro de trabajo incrustado por uno modificado, el gráfico conserva sus colecciones originales de series y categorías. Esta discrepancia puede provocar que IChart.ValidateChartLayout falle con un error de índice fuera de rango. Elimine las series y categorías existentes antes de escribir el libro de trabajo actualizado de nuevo en el gráfico. Este ejemplo usa un gráfico que es la primera forma de la primera diapositiva. El comentario marca dónde ocurriría la edición del libro de trabajo; el ejemplo ejecutable escribe el libro de trabajo original de nuevo y valida el diseño en memoria.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation("chart.pptx");
var slide = presentation.Slides[0];
var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
var chartData = chart.ChartData;
using var workbookStream = chartData.ReadWorkbookStream();
// Modificar el flujo del libro de trabajo aquí, por ejemplo, usando Aspose.Cells.
chartData.Series.Clear();
chartData.Categories.Clear();
workbookStream.Position = 0;
chartData.WriteWorkbookStream(workbookStream);
chart.ValidateChartLayout();
}
else
{
Console.WriteLine("The first shape is not a chart.");
}
Eliminar las colecciones elimina referencias a datos obsoletos antes de que el libro de trabajo sea escrito de nuevo. Reconstruya cualquier asignación de series y categorías requerida para el libro de trabajo actualizado antes de usar el gráfico.
Establecer formatos numéricos personalizados para celdas del libro de trabajo
Utilice ChartDataCell.CustomNumberFormat para controlar cómo aparecen los valores numéricos en el libro de trabajo incrustado de un gráfico. Por ejemplo, un informe puede necesitar que una tasa de conversión se muestre como porcentaje con cuatro decimales y que un coeficiente se muestre con cinco decimales. Mantenga ambos valores como numéricos para que sigan estando disponibles para cálculos y trazado del gráfico.
Un formato numérico cambia la visualización, no el valor almacenado. El formato 0.0000% muestra 0.125 como 12.5000%; no sustituye el número almacenado por 12.5. De manera similar, 0.00000 muestra 0.1234567 como 0.12346 sin redondear el valor almacenado. Si el formato personalizado es una cadena vacía (""), se utiliza PresetNumberFormat en su lugar.
El siguiente ejemplo crea un gráfico de columnas y accede a sus celdas mediante ChartDataWorkbook. En la hoja 0, B2 contiene la tasa de conversión y C2 contiene el coeficiente. Ambas celdas suministran valores al gráfico. El ejemplo también habilita etiquetas de valor vinculadas a los formatos de origen.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(720, 270, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 20, 620, 210);
chart.HasTitle = false;
chart.Axes.VerticalAxis.IsNumberFormatLinkedToSource = false;
chart.Axes.VerticalAxis.NumberFormat = "0.00";
chart.Axes.VerticalAxis.IsAutomaticMinValue = false;
chart.Axes.VerticalAxis.MinValue = 0;
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);
var categoryCell = workbook.GetCell(0, "A2", "Sample");
chart.ChartData.Categories.Add(categoryCell);
var percentageCell = workbook.GetCell(0, "B2", 0.125);
percentageCell.CustomNumberFormat = "0.0000%";
var percentageName = workbook.GetCell(0, "B1", "Conversion rate");
var percentageSeries = chart.ChartData.Series.Add(percentageName, chart.Type);
percentageSeries.DataPoints.AddDataPointForBarSeries(percentageCell);
var precisionCell = workbook.GetCell(0, "C2", 0.1234567);
precisionCell.CustomNumberFormat = "0.00000";
var precisionName = workbook.GetCell(0, "C1", "Coefficient");
var precisionSeries = chart.ChartData.Series.Add(precisionName, chart.Type);
precisionSeries.DataPoints.AddDataPointForBarSeries(precisionCell);
foreach (var series in chart.ChartData.Series)
{
var labelFormat = series.DataPoints[0].Label.DataLabelFormat;
labelFormat.ShowValue = true;
labelFormat.IsNumberFormatLinkedToSource = true;
}
presentation.Save("CustomCellFormats.pptx", SaveFormat.Pptx);
Los formatos de celda del libro de trabajo son independientes de los formatos establecidos directamente en los ejes del gráfico o en las etiquetas de datos. En este ejemplo, cada etiqueta muestra el valor de su celda de origen porque ShowValue está habilitado, y sigue el formato numérico de origen porque IsNumberFormatLinkedToSource es true. Después de guardar y volver a abrir la presentación, las etiquetas muestran 12.5000% y 0.12346, como se muestra a continuación. El eje vertical usa su propio NumberFormat de 0.00, con IsNumberFormatLinkedToSource establecido en false.
Para formatear una etiqueta de datos de forma independiente, establezca su bandera de vínculo a fuente en false y asigne su NumberFormat. Esto no cambia el formato de la celda del libro de trabajo. Por ejemplo, un formato de etiqueta independiente de 0.00 muestra el primer valor como 0.13, mientras que B2 sigue mostrando 12.5000%. Consulte Etiquetas de datos del gráfico para formatear etiquetas directamente.
La imagen a continuación se generó a partir de la presentación guardada después de volver a abrirla:

Establecer una celda del libro de trabajo como etiqueta de datos del gráfico
Puede usar texto de celdas del libro de trabajo como etiquetas de datos del gráfico.
Este ejemplo añade un gráfico de burbujas con datos predeterminados a la primera diapositiva de una presentación existente. Utiliza las celdas A10:A12 en la hoja 0 para las tres primeras etiquetas de la primera serie, habilita las etiquetas desde celdas y guarda la presentación actualizada.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation("chart2.pptx");
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Bubble, 50, 50, 600, 400, true);
var series = chart.ChartData.Series[0];
var workbook = chart.ChartData.ChartDataWorkbook;
series.Labels.DefaultDataLabelFormat.ShowLabelValueFromCell = true;
series.Labels[0].ValueFromCell = workbook.GetCell(0, "A10", "Label 0 cell value");
series.Labels[1].ValueFromCell = workbook.GetCell(0, "A11", "Label 1 cell value");
series.Labels[2].ValueFromCell = workbook.GetCell(0, "A12", "Label 2 cell value");
presentation.Save("resultchart.pptx", SaveFormat.Pptx);
Gestionar hojas de cálculo
La propiedad IChartDataWorkbook.Worksheets proporciona acceso a las hojas de cálculo de un libro de trabajo de gráfico. Este ejemplo crea un gráfico circular con datos predeterminados e imprime cada nombre de hoja en la consola.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Pie, 50, 50, 400, 500);
var workbook = chart.ChartData.ChartDataWorkbook;
for (var i = 0; i < workbook.Worksheets.Count; i++)
{
Console.WriteLine(workbook.Worksheets[i].Name);
}
Especificar el tipo de origen de datos
Los valores de los puntos de serie también pueden almacenarse directamente como literales numéricos. Consulte Establecer valores de serie mediante literales numéricos para un ejemplo completo que los guarda y los lee. El tipo de origen de los valores de los puntos es independiente de la configuración interna o externa del libro de trabajo del gráfico; usar literales numéricos no elimina, por sí mismo, el libro de trabajo incrustado.
Este ejemplo crea un gráfico de columnas 3D con datos predeterminados y establece dos nombres de serie usando diferentes orígenes de datos. El primer nombre usa un literal de cadena; el segundo usa la celda C1 en la hoja 0. La enumeración DataSourceType selecciona el origen para cada nombre. El ejemplo guarda la presentación con los nombres de serie actualizados.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Column3D, 50, 50, 600, 400, true);
var literalName = chart.ChartData.Series[0].Name;
literalName.DataSourceType = DataSourceType.StringLiterals;
literalName.Data = "LiteralString";
var cellName = chart.ChartData.Series[1].Name;
var nameCell = chart.ChartData.ChartDataWorkbook.GetCell(0, "C1", "NewCell");
cellName.DataSourceType = DataSourceType.Worksheet;
cellName.Data = nameCell;
presentation.Save("pres.pptx", SaveFormat.Pptx);
Detectar formatos de libro de trabajo incrustado no compatibles
Aspose.Slides no es compatible con el formato de libro de trabajo binario de Excel (.xlsb) que puede incrustarse en algunos gráficos. Puede usar la propiedad EmbeddedWorkbookType de IChartData junto con la enumeración WorkbookType para detectar formatos no compatibles y omitir esos gráficos. Este ejemplo inspecciona las formas de la primera diapositiva de una presentación existente, omite las formas que no son gráficos y muestra un mensaje de diagnóstico para cada gráfico con un libro de trabajo .xlsb incrustado.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation("sample.pptx");
var slide = presentation.Slides[0];
foreach (var shape in slide.Shapes)
{
if (shape is not IChart chart)
{
continue;
}
var chartData = chart.ChartData;
var isInternalWorkbook = chartData.DataSourceType == ChartDataSourceType.InternalWorkbook;
var isBinaryMacro = chartData.EmbeddedWorkbookType == WorkbookType.WorkbookBinaryMacro;
if (isInternalWorkbook && isBinaryMacro)
{
Console.WriteLine("Skipping a chart with an unsupported .xlsb workbook.");
continue;
}
// Leer o modificar los datos del libro de trabajo del gráfico compatibles aquí.
}
Libro de trabajo externo
Aspose.Slides admite el uso de libros de trabajo externos como origen de datos para gráficos.
Crear un libro de trabajo externo
Utilice ReadWorkbookStream y SetExternalWorkbook para exportar un libro de trabajo de gráfico incrustado a un archivo y vincular el gráfico a ese libro de trabajo externo.
Este ejemplo crea un gráfico circular con datos predeterminados y exporta su libro de trabajo. Cierra el flujo de salida antes de asignar el libro de trabajo externo como origen de datos del gráfico, y luego guarda la presentación vinculada.
using System.IO;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Pie, 50, 50, 400, 600);
var workbookPath = Path.GetFullPath("externalWorkbook1.xlsx");
using (var workbookStream = chart.ChartData.ReadWorkbookStream())
using (var fileStream = File.Create(workbookPath))
{
workbookStream.CopyTo(fileStream);
}
chart.ChartData.SetExternalWorkbook(workbookPath);
presentation.Save("externalWorkbook.pptx", SaveFormat.Pptx);
Establecer un libro de trabajo externo
Mediante el método SetExternalWorkbook puede asignar un libro de trabajo externo a un gráfico como su origen de datos. Este método también puede usarse para actualizar la ruta al libro de trabajo externo (si éste se ha trasladado).
Aunque no puede editar los datos en libros de trabajo almacenados en ubicaciones remotas o recursos, puede seguir utilizándolos como origen de datos externo. Si se proporciona una ruta relativa para un libro de trabajo externo, se convierte automáticamente en una ruta absoluta.
Este ejemplo usa un libro de trabajo externo cuya hoja llamada Sheet1 contiene un nombre de serie en B1, nombres de categoría en A2:A4 y valores numéricos en B2:B4. El ejemplo crea un gráfico circular, enlaza el libro de trabajo y usa SetRange para mapear A1:B4 a una serie y tres categorías. Guarda la presentación con el gráfico vinculado.
using System.IO;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Pie, 50, 50, 400, 600, true);
var chartData = chart.ChartData;
var workbookPath = Path.GetFullPath("externalWorkbook.xlsx");
chartData.SetExternalWorkbook(workbookPath);
chartData.SetRange("Sheet1!$A$1:$B$4");
presentation.Save("Presentation_with_externalWorkbook.pptx", SaveFormat.Pptx);
El parámetro updateChartData del método SetExternalWorkbook controla si se carga el libro de trabajo.
- Cuando
updateChartDataesfalse, solo se actualiza la ruta del libro de trabajo. Los datos del gráfico no se cargan ni actualizan desde el libro de trabajo de destino, por lo que el libro de trabajo puede estar indisponible. - Cuando
updateChartDataestrue, los datos del gráfico se actualizan desde el libro de trabajo de destino.
El siguiente ejemplo asigna una URL de marcador de posición con updateChartData establecido en false. Conserva los datos predeterminados del gráfico circular y guarda la presentación sin cargar el libro de trabajo no disponible.
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.Pie, 50, 50, 400, 600, true);
chart.ChartData.SetExternalWorkbook("https://example.com/unavailable-workbook.xlsx", false);
presentation.Save("SetExternalWorkbookWithUpdateChartData.pptx", SaveFormat.Pptx);
Obtener la ruta del libro de trabajo externo de un gráfico
Para identificar el libro de trabajo vinculado a un gráfico, compruebe si el gráfico usa un origen de datos externo y recupere su ruta de libro de trabajo.
Este ejemplo inspecciona la primera forma de la primera diapositiva de una presentación con un libro de trabajo externo vinculado. Si es un gráfico vinculado a un libro de trabajo externo, el ejemplo imprime ExternalWorkbookPath en la consola. Luego guarda una copia de la presentación.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation("externalWorkbook.pptx");
var slide = presentation.Slides[0];
var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
var chartData = chart.ChartData;
if (chartData.DataSourceType == ChartDataSourceType.ExternalWorkbook)
{
Console.WriteLine(chartData.ExternalWorkbookPath);
}
else
{
Console.WriteLine("The chart does not use an external workbook.");
}
}
else
{
Console.WriteLine("The first shape is not a chart.");
}
presentation.Save("Result.pptx", SaveFormat.Pptx);
Editar datos del gráfico
Puede editar los datos en libros de trabajo externos del mismo modo que modifica el contenido de los libros de trabajo internos. Cuando un libro de trabajo externo no puede cargarse, se lanza una excepción.
Este ejemplo usa un gráfico que es la primera forma de la primera diapositiva y está vinculado a un libro de trabajo externo accesible. Establece el valor respaldado por celda del primer punto de datos de la primera serie en 100 y guarda la presentación actualizada. Editar valores de celda puede actualizar el archivo XLSX externo vinculado, por lo que debe usar una copia si necesita conservar el libro de trabajo original.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation("presentation.pptx");
var slide = presentation.Slides[0];
var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
var series = chart.ChartData.Series;
if (series.Count > 0 && series[0].DataPoints.Count > 0)
{
var valueCell = series[0].DataPoints[0].Value.AsCell;
if (valueCell != null)
{
valueCell.Value = 100;
presentation.Save("presentation_out.pptx", SaveFormat.Pptx);
}
else
{
Console.WriteLine("The first data point is not linked to a workbook cell.");
}
}
else
{
Console.WriteLine("The chart has no data points to edit.");
}
}
else
{
Console.WriteLine("The first shape is not a chart.");
}
Actualizar datos del gráfico desde libros de trabajo de origen
Aspose.Slides for .NET 26.11 añade IChartData.RefreshData para un gráfico y IPresentation.RefreshChartsData para la presentación. Úselos después de que cambien los valores del libro de trabajo de origen. Los libros de trabajo externos deben ser accesibles y compatibles.
Con Aspose.Slides for .NET 26.11 o posterior instalado, este ejemplo actualiza el primer gráfico de la primera diapositiva de charts.pptx. Su libro de trabajo de origen debe estar disponible. Guarde el resultado para conservar los datos de gráfico actualizados.
using System;
using System.Linq;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation("charts.pptx");
var chart = presentation.Slides[0].Shapes.OfType<IChart>().FirstOrDefault();
if (chart == null)
{
Console.WriteLine("The first slide must contain a chart.");
return;
}
chart.ChartData.RefreshData();
presentation.Save("refreshed-chart.pptx", SaveFormat.Pptx);
Para actualizar todos los gráficos, use una instancia de presentación independiente de la siguiente manera. Pasar false hace que una falla de actualización se propague al llamador; no revierte los gráficos ya actualizados.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("charts.pptx");
presentation.RefreshChartsData(skipFailedCharts: false);
presentation.Save("refreshed-charts.pptx", SaveFormat.Pptx);
El parámetro por defecto es true: RefreshChartsData omite un gráfico que falla y continúa con los demás. No devuelve resultados por gráfico, por lo que una llamada completada no prueba que every gráfico se haya actualizado. Use llamadas individuales a RefreshData si necesita identificar cada gráfico que falla.
Actualizar recarga los datos de origen. Es independiente del cálculo de fórmulas, la validación del diseño del gráfico y la actualización de la vista previa OLE. Inspeccione los valores respaldados por celdas en vivo para comprobar una actualización en memoria. Un CachedValue todavía puede describir el gráfico guardado previamente hasta que guarde y vuelva a abrir la presentación.
Leer valores de gráfico en caché sin un libro de trabajo
En .NET 26.11, los accesores de valores en caché leen los valores almacenados con el gráfico sin abrir su libro de trabajo. Son útiles cuando el archivo vinculado no está disponible y solo necesita los últimos datos guardados del gráfico. Esto difiere de reconstruir un libro de trabajo usando la opción de recuperación a continuación.
| Objeto | Accesor en caché |
|---|---|
| Punto de serie ordinario | CachedValue |
| Punto de dispersión o burbuja | CachedXValue, CachedYValue |
| Punto de burbuja | CachedBubbleSize |
| Categoría del gráfico | CachedValue |
Cada accesor devuelve un ICachedChartValue. Data expone el objeto almacenado; ToString proporciona texto; ToDouble devuelve NaN para un valor ausente o no numérico. Una caché puede estar ausente o desactualizada, incluso en un gráfico recién creado que no se haya guardado. No asuma que cada campo exista o contenga un número.
Este ejemplo lee todos esos campos de cached-chart.pptx, una presentación guardada que contiene gráficos. Un libro de trabajo externo ausente es aceptable porque el código no accede a ChartDataWorkbook ni a celdas de libro de trabajo en vivo.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation("cached-chart.pptx");
foreach (var slide in presentation.Slides)
foreach (var shape in slide.Shapes)
{
if (shape is not IChart chart)
continue;
foreach (var category in chart.ChartData.Categories)
PrintCache("Category", category.CachedValue);
foreach (var series in chart.ChartData.Series)
foreach (var point in series.DataPoints)
{
PrintCache("Value", point.CachedValue);
PrintCache("X", point.CachedXValue);
PrintCache("Y", point.CachedYValue);
PrintCache("Bubble size", point.CachedBubbleSize);
}
}
static void PrintCache(string name, ICachedChartValue value)
{
var number = value.ToDouble();
if (value.Data == null)
Console.WriteLine($"{name}: no cached value");
else if (double.IsNaN(number))
Console.WriteLine($"{name}: {value} (not numeric)");
else
Console.WriteLine($"{name}: {number}");
}
Use la actualización cuando necesite datos de origen actuales; use lecturas en caché cuando la instantánea almacenada sea suficiente. La caché no es una copia completa del libro de trabajo y no puede proporcionar cambios realizados después de su última actualización.
Recuperar un libro de trabajo a partir de la caché del gráfico
Si un gráfico usa un libro de trabajo externo que falta o no está disponible, Aspose.Slides puede reconstruir el libro de trabajo del gráfico a partir de los datos almacenados en caché en la presentación. Cree LoadOptions, configure su SpreadsheetOptions, y establezca ISpreadsheetOptions.RecoverWorkbookFromChartCache en true antes de abrir la presentación.
El siguiente ejemplo en C# recupera datos de libro de trabajo para un gráfico que es la primera forma de la primera diapositiva y referencia un libro de trabajo externo no disponible. Accede a los datos recuperados mediante IChart.ChartData y IChartData.ChartDataWorkbook:
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
var spreadsheetOptions = new SpreadsheetOptions
{
RecoverWorkbookFromChartCache = true
};
var loadOptions = new LoadOptions
{
SpreadsheetOptions = spreadsheetOptions
};
using var presentation = new Presentation("presentation.pptx", loadOptions);
var slide = presentation.Slides[0];
var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
var recoveredWorkbook = chart.ChartData.ChartDataWorkbook;
// Leer o modificar los datos del libro de trabajo recuperado aquí.
}
else
{
Console.WriteLine("The first shape is not a chart.");
}
Si el código accede al libro de trabajo externo mientras está indisponible y la recuperación está deshabilitada, Aspose.Slides lanza una InvalidOperationException. Habilite la recuperación solo cuando usar los datos en caché del gráfico sea una alternativa aceptable, porque la caché puede no contener cambios realizados en el libro de trabajo externo después de la última actualización de la presentación.
Preguntas frecuentes
¿Puedo determinar si un gráfico concreto está vinculado a un libro de trabajo externo o a uno incrustado?
Sí. Un gráfico tiene un tipo de origen de datos y una ruta a un libro de trabajo externo; si el origen es un libro de trabajo externo, puede leer la ruta completa para confirmar que se está usando un archivo externo.
¿Se admiten rutas relativas a libros de trabajo externos y cómo se almacenan?
Sí. Si especifica una ruta relativa, se convierte automáticamente en una ruta absoluta. La presentación almacena la ruta absoluta en el archivo PPTX, por lo que mover el libro de trabajo puede requerir actualizar el vínculo.
¿Puedo usar libros de trabajo ubicados en recursos/redes compartidas?
Sí, esos libros pueden usarse como origen de datos externo. Sin embargo, la edición directa de libros remotos desde Aspose.Slides no está soportada; solo pueden usarse como fuente.
¿Aspose.Slides sobrescribe el XLSX externo al guardar la presentación?
La presentación almacena un enlace al archivo externo. Editar datos de gráfico respaldados por celdas también puede actualizar el archivo XLSX local vinculado. Use una copia del libro de trabajo si el original debe permanecer sin cambios.
¿Qué debo hacer si el archivo externo está protegido con contraseña?
Aspose.Slides no acepta una contraseña al crear el vínculo. Un enfoque habitual es eliminar la protección con antelación o preparar una copia descifrada (por ejemplo, usando Aspose.Cells) y vincular a esa copia.
¿Pueden varios gráficos referenciar el mismo libro de trabajo externo?
Sí. Cada gráfico almacena su propio vínculo. Si todos apuntan al mismo archivo, actualizar ese archivo se reflejará en cada gráfico la próxima vez que se carguen los datos.

