Crear gráficos en documentos de Word usando C#

Como desarrollador de C#, puede insertar varios tipos de gráficos en documentos de Word mediante programación. Ayuda a presentar gráficamente sus datos e información. En este artículo, aprenderá cómo crear gráficos en documentos de Word usando C#.

Los siguientes temas se discuten/tratan en este artículo:

• API de C# para insertar gráficos en documentos de Word
• Crear gráficos de columnas en documentos de Word
• Cree gráficos de dispersión en documentos de Word usando C#
• Insertar gráficos de área en documentos de Word usando C#
• Insertar gráficos de burbujas en documentos de Word usando C#

API de C# para insertar gráficos en documentos de Word

Para insertar gráficos en archivos DOCX, usaremos Aspose.Words para .NET API. Le permite generar, modificar, convertir, renderizar e imprimir archivos sin utilizar Microsoft Word directamente en aplicaciones multiplataforma. La API le permite insertar varios tipos de gráficos admitidos en documentos de Word mediante programación.

Puede descargar la DLL de la API o instalarla mediante NuGet.

Install-Package Aspose.Words

Crear gráficos de columnas en documentos de Word

Puede crear gráficos de columnas en documentos de Word mediante programación siguiendo los pasos que se detallan a continuación:

• En primer lugar, cree un nuevo documento utilizando la clase Documento.
• Ahora, cree una instancia de la clase DocumentBuilder con el objeto de la clase Document.
• Luego, llame al método DocumentBuilder.InsertChart(). Pase ChartType como columna, con alto y ancho como parámetros de entrada.
• Obtenga resultados en el objeto de clase Shape.
• Ahora, cree una instancia de la clase Chart y asígnele el objeto Shape.Chart. Proporciona acceso a las propiedades del gráfico si esta forma tiene un gráfico.
• Luego, obtenga la colección de series de gráficos en el objeto ChartSeriesCollection.
• Crear matriz de nombres de categoría.
• Ahora, llame al método ChartSeriesCollection.Add() para agregar series de gráficos. Pase el nombre, la matriz de categoría y los valores como parámetros de entrada. Repita este paso para agregar más series.
• Finalmente, llame al método Document.Save() con la ruta del archivo de salida para guardar el archivo.

El siguiente ejemplo de código muestra cómo crear un gráfico de columnas en un documento de Word usando C#.

// Crear un documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Agregar gráfico con datos predeterminados. Puede especificar diferentes tipos y tamaños de gráficos.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// La propiedad Chart de Shape contiene todas las opciones relacionadas con el gráfico.
Chart chart = shape.Chart;

// Obtenga la colección de series de gráficos.
ChartSeriesCollection seriesColl = chart.Series;
// Verifique el conteo de series.
Console.WriteLine(seriesColl.Count);

// Elimina la serie generada por defecto.
seriesColl.Clear();

// Cree una matriz de nombres de categoría, en este ejemplo tenemos dos categorías.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Agregando nueva serie. Tenga en cuenta que las matrices de datos no deben estar vacías y las matrices deben tener el mismo tamaño.
seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("AW Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("AW Series 5", categories, new double[] { 9, 10 });

// Guardar el documento
doc.Save(@"C:\Files\Words\ColumnsChart.docx");

Cree gráficos de dispersión en documentos de Word usando C#

Puede insertar gráficos de dispersión en sus documentos de Word mediante programación siguiendo los pasos mencionados anteriormente. Sin embargo, debe establecer ChartType.Scatter en el método DocumentBuilder.InsertChart().

El siguiente ejemplo de código muestra cómo crear un gráfico de dispersión en un documento de Word usando C#.

// Crear un nuevo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insertar gráfico de dispersión.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// Use esta sobrecarga para agregar series a cualquier tipo de gráficos de dispersión.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Guardar el documento
doc.Save(@"C:\Files\Words\ScatterChart.docx");

Insertar gráficos de área en documentos de Word usando C#

Puede insertar gráficos de área en documentos de Word mediante programación siguiendo los pasos mencionados anteriormente. Sin embargo, debe establecer ChartType.Area en el método DocumentBuilder.InsertChart().

El siguiente ejemplo de código muestra cómo crear un gráfico de área en un documento de Word usando C#.

// Crear un nuevo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insertar gráfico de área.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// Use esta sobrecarga para agregar series a cualquier tipo de gráficos de área, radar y cotizaciones.
chart.Series.Add("AW Series 1", new DateTime[] {
    new DateTime(2002, 05, 01),
    new DateTime(2002, 06, 01),
    new DateTime(2002, 07, 01),
    new DateTime(2002, 08, 01),
    new DateTime(2002, 09, 01)},
    new double[] { 32, 32, 28, 12, 15 });

// Guardar el documento
doc.Save(@"C:\Files\Words\AreaChart.docx");

Insertar gráficos de burbujas en documentos de Word usando C#

Puede insertar gráficos de burbujas en documentos de Word mediante programación siguiendo los pasos mencionados anteriormente. Sin embargo, debe establecer ChartType.Bubble en el método DocumentBuilder.InsertChart().

El siguiente ejemplo de código muestra cómo crear un gráfico de burbujas en un documento de Word usando C#.

// Crear un nuevo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insertar gráfico de burbujas.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// Utilice esta sobrecarga para agregar series a cualquier tipo de gráfico de burbujas.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 }, new double[] { 10, 4, 8 });

// Guardar el documento
doc.Save(@"C:\Files\Words\BubbleChart.docx");

Obtenga una licencia gratis

Puede probar la API sin limitaciones de evaluación solicitando una licencia temporal gratuita.

Conclusión

En este artículo, ha aprendido a crear gráficos en documentos de Word usando C#. En particular, ha aprendido cómo crear gráficos de columnas, áreas, burbujas y dispersión en documentos de Word mediante programación. Del mismo modo, puede crear otros tipos de gráficos. Puede obtener más información sobre Aspose.Words para la API de .NET utilizando la documentación. En caso de cualquier ambigüedad, no dude en contactarnos en el foro.

Ver también

• Trabajar con la tabla de contenido en un documento de Word C#