作为 C# 开发人员,您可以通过编程方式在 Word 文档中插入各种类型的图表。它有助于以图形方式呈现您的数据和信息。在本文中,您将学习如何使用 C# 在 Word 文档中创建图表。
本文讨论/涵盖了以下主题:
- 在 Word 文档中插入图表的 C# API
- 在 Word 文档中创建柱形图
- 使用 C# 在 Word 文档中创建散点图
- 使用 C# 在 Word 文档中插入面积图
- 使用 C# 在 Word 文档中插入气泡图
在 Word 文档中插入图表的 C# API
为了在 DOCX 文件中插入图表,我们将使用 Aspose.Words for .NET API。它允许您生成、修改、转换、渲染和打印文件,而无需直接在跨平台应用程序中使用 Microsoft Word。 API 使您能够以编程方式在 Word 文档中插入各种 支持的图表类型。
您可以下载 API 的 DLL 或使用 NuGet 安装它。
Install-Package Aspose.Words
在 Word 文档中创建柱形图
您可以按照以下步骤以编程方式在 Word 文档中创建柱形图:
- 首先,使用 Document 类创建一个新文档。
- 现在,使用 Document 类对象创建 DocumentBuilder 类的实例。
- 然后,调用 DocumentBuilder.InsertChart() 方法。将 ChartType 作为 Column 传递,高度和宽度作为输入参数。
- 在 Shape 类对象中获取结果。
- 现在,创建 Chart 类的实例并将 Shape.Chart 对象分配给它。如果此形状具有图表,则它提供对图表属性的访问。
- 然后,在 ChartSeriesCollection 对象中获取图表系列集合。
- 创建类别名称数组。
- 现在,调用 ChartSeriesCollection.Add() 方法来添加图表系列。传递名称、类别数组和值作为输入参数。重复此步骤以添加更多系列。
- 最后,调用带有输出文件路径的Document.Save()方法来保存文件。
以下代码示例演示如何使用 C# 在 Word 文档中创建柱形图。
// 创建文档
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// 添加带有默认数据的图表。您可以指定不同的图表类型和大小。
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
// Shape 的图表属性包含所有图表相关选项。
Chart chart = shape.Chart;
// 获取图表系列集合。
ChartSeriesCollection seriesColl = chart.Series;
// 检查系列计数。
Console.WriteLine(seriesColl.Count);
// 删除默认生成的系列。
seriesColl.Clear();
// 创建类别名称数组,在此示例中,我们有两个类别。
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// 添加新系列。请注意,数据数组不能为空,并且数组的大小必须相同。
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 });
// 保存文档
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
使用 C# 在 Word 文档中创建散点图
您可以按照前面提到的步骤以编程方式在 Word 文档中插入散点图。但是,您需要在 DocumentBuilder.InsertChart() 方法中设置 ChartType.Scatter。
以下代码示例演示如何使用 C# 在 Word 文档中创建散点图。
// 创建一个新文档
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// 插入散点图。
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;
// 使用此重载将系列添加到任何类型的散点图。
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
// 保存文档
doc.Save(@"C:\Files\Words\ScatterChart.docx");
使用 C# 在 Word 文档中插入面积图
您可以按照前面提到的步骤以编程方式在 Word 文档中插入面积图。但是,您需要在 DocumentBuilder.InsertChart() 方法中设置 ChartType.Area。
以下代码示例演示如何使用 C# 在 Word 文档中创建面积图。
// 创建一个新文档
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// 插入面积图。
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;
// 使用此重载将系列添加到任何类型的区域、雷达和股票图表。
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 });
// 保存文档
doc.Save(@"C:\Files\Words\AreaChart.docx");
使用 C# 在 Word 文档中插入气泡图
您可以按照前面提到的步骤以编程方式在 Word 文档中插入气泡图。但是,您需要在 DocumentBuilder.InsertChart() 方法中设置 ChartType.Bubble。
以下代码示例展示了如何使用 C# 在 Word 文档中创建气泡图。
// 创建一个新文档
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// 插入气泡图。
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;
// 使用此重载将系列添加到任何类型的气泡图。
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 });
// 保存文档
doc.Save(@"C:\Files\Words\BubbleChart.docx");
获得免费许可证
您可以通过请求 免费的临时许可证 来试用该 API,而不受评估限制。
结论
在本文中,您学习了如何使用 C# 在 Word 文档中创建图表。特别是,您学习了如何以编程方式在 Word 文档中创建柱形图、面积图、气泡图和散点图。同样,您可以创建其他类型的图表。您可以使用 文档 了解更多关于 Aspose.Words for .NET API 的信息。如有任何歧义,请随时在 论坛 上与我们联系。