引言

在辦公自動(dòng)化需求不斷增長(zhǎng)的今天，越來(lái)越多的企業(yè)希望將數(shù)據(jù)可視化工作融入自動(dòng)化文檔生成流程中。過(guò)去，我們通常依賴(lài) Excel 或 PowerPoint 來(lái)制作圖表，再手工插入到 Word 文檔中。然而，當(dāng)需要生成大量報(bào)告、需要頻繁更新數(shù)據(jù)、或需要根據(jù)程序邏輯動(dòng)態(tài)繪制不同結(jié)構(gòu)的圖表時(shí)，手動(dòng)操作顯然變得低效且容易出錯(cuò)。

將圖表直接通過(guò)代碼生成到 Word 文檔里，可以讓整個(gè)流程變得更加自動(dòng)化、可復(fù)用且更具擴(kuò)展性。無(wú)論是數(shù)據(jù)分析報(bào)告、季度業(yè)務(wù)總結(jié)，還是工程文檔，你都可以通過(guò)幾行 C# 代碼快速繪制專(zhuān)業(yè)圖表，并將其以最高一致性嵌入到文檔中。

本文將演示如何在 Word 文檔中創(chuàng)建圖表，同時(shí)展示如何對(duì)圖表的標(biāo)題、圖例、坐標(biāo)軸、數(shù)據(jù)標(biāo)簽和數(shù)據(jù)表進(jìn)行定制，使圖表不僅正確展示數(shù)據(jù)，更具專(zhuān)業(yè)觀感。

本文使用的方法需要 Free Spire.Doc for .NET，通過(guò)NuGet安裝：Install-Package FreeSpire.Doc。

用 C# 創(chuàng)建 Word 文檔，插入圖表并保存

使用 Free Spire.Doc for .NET，我們可以實(shí)現(xiàn)從 Word 文檔創(chuàng)建、圖表插入、數(shù)據(jù)設(shè)置、圖表設(shè)置到文檔保存的全流程，下面的示例將展示如何使用 Free Spire.Doc for .NET 創(chuàng)建 Word 文檔，并插入餅圖和氣泡圖。

創(chuàng)建文檔插入餅圖

下面的示例首先創(chuàng)建一個(gè) Word 文檔，然后在其中插入一個(gè)餅圖。為了便于演示，我們使用“軟件使用占比”作為樣例數(shù)據(jù)。

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using Spire.Doc.Fields.Shapes.Charts;

Document doc = new Document();
Section section = doc.AddSection();
Paragraph paragraph = section.AddParagraph();

// 插入餅圖
ShapeObject shape = paragraph.AppendChart(ChartType.Pie, 480f, 300f);
Chart pieChart = shape.Chart;
pieChart.Series.Clear();

// 分類(lèi)與數(shù)據(jù)
string[] categories = { "Word", "Excel", "PDF" };
double[] usageData = { 45.2, 38.6, 16.2 };

// 添加數(shù)據(jù)系列
ChartSeries series = pieChart.Series.Add("Usage Share", categories, usageData);

// 添加標(biāo)題
ChartTitle title = pieChart.Title;
title.Show = true;
title.Text = "辦公軟件使用占比（季度數(shù)據(jù)）";

在這個(gè)階段，我們已經(jīng)成功在 Word 文檔中創(chuàng)建了一個(gè)餅圖，并且定義了分類(lèi)標(biāo)簽與對(duì)應(yīng)的數(shù)據(jù)。相比手工制作，這種方式適用于長(zhǎng)期維護(hù)，特別是在數(shù)據(jù)基于數(shù)據(jù)庫(kù)或后臺(tái)系統(tǒng)實(shí)時(shí)生成時(shí)優(yōu)勢(shì)更加明顯。

在文檔中插入氣泡圖

氣泡圖適合用于展示三維數(shù)據(jù)（X 值、Y 值、氣泡大?。?，常見(jiàn)于市場(chǎng)分析、產(chǎn)品對(duì)比或投資評(píng)估。下面的示例展示如何在 Word 文檔中添加一個(gè)氣泡圖。

Paragraph bubblePara = section.AddParagraph();

// 插入氣泡圖
ShapeObject bubbleShape = bubblePara.AppendChart(ChartType.Bubble, 500f, 320f);
Chart bubbleChart = bubbleShape.Chart;
bubbleChart.Series.Clear();

// 三維數(shù)據(jù)示例
double[] xValues = { 2.3, 3.1, 4.0, 5.2, 3.8 };
double[] yValues = { 1.5, 3.7, 2.8, 4.6, 2.0 };
double[] bubbleSizes = { 10, 25, 15, 30, 18 };

ChartSeries bubbleSeries = bubbleChart.Series.Add("市場(chǎng)定位", xValues, yValues, bubbleSizes);

// 添加標(biāo)題
ChartTitle bubbleTitle = bubbleChart.Title;
bubbleTitle.Show = true;
bubbleTitle.Text = "產(chǎn)品市場(chǎng)定位分析";

通過(guò)這段代碼，我們不僅展示了數(shù)據(jù)在二維空間的關(guān)系，還將氣泡大小作為第三個(gè)維度進(jìn)行可視化，幫助讀者從多個(gè)層面理解數(shù)據(jù)結(jié)構(gòu)。

保存文檔

doc.SaveToFile("ChartInWordDocument.docx", FileFormat.Docx);

保存后的文檔即可直接打開(kāi)查看，其中包含餅圖與氣泡圖，并保留完整的圖表樣式、標(biāo)簽與標(biāo)題。

以下是文檔預(yù)覽：

高級(jí)設(shè)置：圖表標(biāo)題、圖例、坐標(biāo)軸與數(shù)據(jù)標(biāo)簽的定制

一個(gè)專(zhuān)業(yè)可讀的圖表需要清晰的標(biāo)題、合適的圖例布局、規(guī)范的坐標(biāo)軸標(biāo)注以及帶解釋性的標(biāo)簽。下面展示這些輔助函數(shù)，可根據(jù)項(xiàng)目需求按需調(diào)用。

圖表標(biāo)題

void AppendChartTitle(Chart chart, string titleText)
{
    ChartTitle title = chart.Title;
    title.Show = true;
    title.Overlay = false;
    title.Text = titleText;
    title.CharacterFormat.FontSize = 13;
    title.CharacterFormat.Bold = true;
    title.CharacterFormat.TextColor = System.Drawing.Color.DarkBlue;
}

標(biāo)題不僅提升圖表可讀性，也為文檔提供清晰的上下文信息。

圖例樣式

void AppendChartLegend(Chart chart)
{
    chart.Legend.Show = true;
    chart.Legend.Position = LegendPosition.Right;
    chart.Legend.CharacterFormat.FontSize = 9;
    chart.Legend.CharacterFormat.Italic = true;
    chart.Legend.CharacterFormat.TextColor = System.Drawing.Color.DarkGreen;
}

在餅圖中，圖例尤其重要，便于用戶(hù)快速理解每個(gè)扇區(qū)代表的內(nèi)容。

坐標(biāo)軸自定義（適用于柱狀圖、折線圖等）

void AppendChartAxis(Chart chart)
{
    if (chart.Axes.Count > 0)
    {
        chart.Axes[0].Title.Text = "產(chǎn)品類(lèi)別";
        chart.Axes[0].Title.Show = true;
    }

    if (chart.Axes.Count > 1)
    {
        chart.Axes[1].Title.Text = "銷(xiāo)量";
        chart.Axes[1].Title.Show = true;
        chart.Axes[1].HasMajorGridlines = true;
    }
}

雖然餅圖不使用坐標(biāo)軸，但氣泡圖、折線圖或柱狀圖都依賴(lài)軸線提供數(shù)值參考信息。

數(shù)據(jù)標(biāo)簽（可展示數(shù)值、百分比、氣泡大小等）

void AppendChartDataLabel(Chart chart, ChartType chartType)
{
    if (chart.Series.Count == 0) return;

    ChartSeries series = chart.Series[0];
    series.HasDataLabels = true;
    var labels = series.DataLabels;

    labels.ShowValue = true;
    labels.ShowCategoryName = true;
    labels.CharacterFormat.FontSize = 10;
    labels.CharacterFormat.TextColor = System.Drawing.Color.Black;

    if (chartType == ChartType.Pie)
        labels.ShowPercentage = true;
    if (chartType == ChartType.Bubble)
        labels.ShowBubbleSize = true;

    labels.Separator = " / ";
}

數(shù)據(jù)標(biāo)簽的展示方式對(duì)于圖表可解釋性影響巨大。對(duì)于餅圖，百分比是重要元素；對(duì)于氣泡圖，顯示氣泡大小同樣關(guān)鍵。

添加數(shù)據(jù)表（適用于需要同時(shí)展示圖表與原始數(shù)據(jù)）

void AppendChartDataTable(Chart chart)
{
    chart.DataTable.Show = true;
    chart.DataTable.ShowHorizontalBorder = true;
    chart.DataTable.ShowVerticalBorder = true;
}

數(shù)據(jù)表適用于審計(jì)要求高、需要精確數(shù)據(jù)對(duì)照的文檔，例如財(cái)務(wù)報(bào)告。

關(guān)鍵類(lèi)與方法解析

在使用 Spire.Doc 自動(dòng)化創(chuàng)建 Word 圖表的過(guò)程中，理解核心對(duì)象的職責(zé)與作用，可以讓我們?cè)诤罄m(xù)擴(kuò)展——例如添加更多圖表類(lèi)型、定制樣式、批量生成文檔——時(shí)更加得心應(yīng)手。下面從實(shí)際開(kāi)發(fā)最常用的維度，對(duì)相關(guān)類(lèi)和屬性進(jìn)行簡(jiǎn)要說(shuō)明。

Document 與 Section：承載整個(gè) Word 文檔結(jié)構(gòu)

Document 是 Word 文件的根對(duì)象，負(fù)責(zé)創(chuàng)建、保存、加載文檔。在文檔中，每一個(gè)獨(dú)立的主體部分都由 Section 承載：它決定頁(yè)面的布局、邊距、方向，也包含段落、表格和圖表等內(nèi)容。

常用方法：

• Document.AddSection()：添加文檔主體區(qū)域
• Document.SaveToFile()：將文檔保存為 .docx 或 .pdf

Paragraph 與 ShapeObject：圖表的插入位置

圖表是以 ShapeObject 的形式插入到段落 (Paragraph) 中的。段落控制位置和排版，而圖表 Shape 則占據(jù)具體的區(qū)域。

關(guān)鍵方法：

• Paragraph.AppendChart(ChartType type, float width, float height)：創(chuàng)建圖表并返回 ShapeObject

當(dāng)然可以！我將在你剛才加入的 “關(guān)鍵類(lèi)與方法解析” 中，補(bǔ)充一個(gè)獨(dú)立的 “### ChartType：圖表類(lèi)型枚舉” 三級(jí)標(biāo)題，與其他小節(jié)并列，內(nèi)容完整、專(zhuān)業(yè)、自然，可直接插入使用。

下面是新增的小節(jié)內(nèi)容（保持與你文章風(fēng)格一致）——

ChartType：圖表類(lèi)型枚舉

在創(chuàng)建圖表時(shí)，ChartType 是最基礎(chǔ)但也最關(guān)鍵的枚舉類(lèi)型，它決定了圖表的整體視覺(jué)結(jié)構(gòu)與功能特性。Spire.Doc 提供了與 Word 原生圖表一致的圖表類(lèi)型，包括餅圖、柱形圖、折線圖、面積圖、氣泡圖、散點(diǎn)圖等。選擇合適的圖表類(lèi)型，不僅影響數(shù)據(jù)表達(dá)的清晰度，也決定后續(xù)能否配置軸、網(wǎng)格線、百分比標(biāo)簽等高級(jí)樣式。

常用圖表類(lèi)型示例：

• ChartType.Pie / Pie3D適用于比例分布展示，可顯示百分比和類(lèi)別標(biāo)簽，常用于市場(chǎng)份額、占比結(jié)構(gòu)。
• ChartType.ColumnClustered（簇狀柱形圖）用于對(duì)比不同類(lèi)別的數(shù)據(jù)，可自定義 X/Y 軸，是最常見(jiàn)的業(yè)務(wù)圖表類(lèi)型。
• ChartType.Line（折線圖）用于展示趨勢(shì)變化，可配合網(wǎng)格線提升可讀性。
• ChartType.Bubble / Bubble3D用于多維數(shù)據(jù)展示（X、Y、氣泡大小），適合市場(chǎng)分析、產(chǎn)品定位圖。
• ChartType.Bar（條形圖）與柱形圖結(jié)構(gòu)類(lèi)似，但橫向展示更適合長(zhǎng)標(biāo)簽或排名類(lèi)數(shù)據(jù)。

在使用 AppendChart() 時(shí)，只需傳入其中一種類(lèi)型即可生成對(duì)應(yīng)圖表，例如：

ShapeObject shape = paragraph.AppendChart(ChartType.Pie, 500, 300);

選擇合適的 ChartType 不僅影響可視效果，也決定了后續(xù)能否配置坐標(biāo)軸、百分比顯示、數(shù)據(jù)標(biāo)簽內(nèi)容等內(nèi)容，因此在文檔自動(dòng)化過(guò)程中是必須重點(diǎn)關(guān)注的參數(shù)之一。

Chart 與 ChartSeries：圖表數(shù)據(jù)與樣式的核心

Chart 是 Word 圖表最重要的類(lèi)，它包含圖表的坐標(biāo)軸、數(shù)據(jù)系列、標(biāo)題、圖例，以及圖表的數(shù)據(jù)表。

常用屬性與方法：

• chart.Series.Add(name, categories, values)：添加一個(gè)數(shù)據(jù)系列
• chart.Title：訪問(wèn)圖表標(biāo)題
• chart.Legend：訪問(wèn)圖例
• chart.DataTable：訪問(wèn)圖表下方的數(shù)據(jù)表
• chart.Axes：訪問(wèn) X/Y 軸對(duì)象（用于線形圖、柱形圖、折線圖等）

ChartAxis（坐標(biāo)軸控制）

當(dāng)圖表類(lèi)型需要坐標(biāo)軸（例如柱形圖、折線圖、散點(diǎn)圖、氣泡圖），可通過(guò) Axes[0]、Axes[1] 分別設(shè)置 X 軸和 Y 軸。

常見(jiàn)配置：

• Title.Text：坐標(biāo)軸標(biāo)題
• HasMajorGridlines：是否顯示主要網(wǎng)格線
• Labels.Position：軸標(biāo)簽位置

ChartDataLabel：圖表中的標(biāo)簽文本控制

用于控制顯示數(shù)值、類(lèi)別名稱(chēng)、百分比、氣泡大小等信息。

常用屬性：

• ShowValue
• ShowCategoryName
• ShowPercentage（僅餅圖）
• ShowBubbleSize（僅氣泡圖）

總結(jié)

通過(guò)本文示例可以看到，在 Word 文檔中動(dòng)態(tài)創(chuàng)建圖表并非難事。借助 Spire.Doc for .NET，開(kāi)發(fā)者可以靈活地將數(shù)據(jù)以餅圖、氣泡圖等形式呈現(xiàn)，并實(shí)現(xiàn)包括標(biāo)題、圖例、坐標(biāo)軸、數(shù)據(jù)標(biāo)簽和數(shù)據(jù)表在內(nèi)的全面定制。相比傳統(tǒng)的手工插圖方式，代碼生成不僅減少重復(fù)勞動(dòng)，更適合大規(guī)模、可擴(kuò)展的文檔生成場(chǎng)景。

無(wú)論你的項(xiàng)目需要自動(dòng)生成業(yè)務(wù)報(bào)告、統(tǒng)計(jì)文檔、市場(chǎng)分析圖表，還是構(gòu)建一套全自動(dòng)化的文檔處理系統(tǒng)，這種方法都能提供極高的靈活性與可靠性。掌握這些圖表定制技巧，將幫助你構(gòu)建更專(zhuān)業(yè)、更智能的企業(yè)級(jí)文檔解決方案。

以上就是使用C#在Word文檔中自動(dòng)化創(chuàng)建與定制圖表的詳細(xì)內(nèi)容，更多關(guān)于C# Word創(chuàng)建與定制圖表的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論