ASP.NET 內建的 Microsoft Chart 控件(System.Web.UI.DataVisualization.Charting)提供了強大的資料視覺化功能,支援多種圖表類型、豐富的樣式設定以及資料繫結。本文將透過完整的範例,示範如何在 ASP.NET Web Forms 專案中正確設定並使用 Chart 控件繪製統計圖表。
使用 Chart 控件前,必須在 Web.config 中註冊 ChartHttpHandler,以便處理圖表圖片的動態產生請求。以下為 IIS 7+ 整合模式與傳統模式通用的設定範例:
<configuration>
<system.webServer>
<handlers>
<remove name="ChartImageHandler" />
<add name="ChartImageHandler" preCondition="integratedMode" verb="GET,HEAD,POST"
path="ChartImg.axd"
type="System.Web.UI.DataVisualization.Charting.ChartHttpHandler, System.Web.DataVisualization, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
</handlers>
</system.webServer>
<system.web>
<httpHandlers>
<add path="ChartImg.axd" verb="GET,HEAD,POST"
type="System.Web.UI.DataVisualization.Charting.ChartHttpHandler, System.Web.DataVisualization, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
validate="false" />
</httpHandlers>
</system.web>
</configuration>
在 .aspx 頁面頂端註冊組件,並在表單中放置多個 <asp:Chart> 控件,展示不同圖表類型與樣式:
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="chart.aspx.cs" Inherits="chart" %>
<%@ Register Assembly="System.Web.DataVisualization, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
Namespace="System.Web.UI.DataVisualization.Charting" TagPrefix="asp" %>
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title>MsChart 圖表控件示範</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<!-- 圖表 1:完整樣式的折線/氣泡圖 -->
<asp:Chart ID="Chart1" runat="server" Width="500px" BorderDashStyle="Solid"
Palette="BrightPastel" ImageType="Png" BackSecondaryColor="White"
BackGradientStyle="TopBottom" BorderWidth="2" BackColor="#D3DFF0"
BorderColor="26, 59, 105">
<Titles>
<asp:Title Font="微軟雅黑, 16pt" Name="Title1" Text="統計表" />
</Titles>
<BorderSkin SkinStyle="Emboss" />
<Series>
<asp:Series Name="Series1" ChartType="Bubble" MarkerSize="8" MarkerStyle="Circle" />
</Series>
<ChartAreas>
<asp:ChartArea Name="ChartArea1" BorderColor="64, 64, 64, 64"
BackSecondaryColor="Transparent" BackColor="64, 165, 191, 228"
ShadowColor="Transparent" BackGradientStyle="TopBottom" />
</ChartAreas>
</asp:Chart>
<!-- 圖表 2:簡易預設圖表 -->
<asp:Chart ID="Chart2" runat="server">
<Series><asp:Series Name="Series1" /></Series>
<ChartAreas><asp:ChartArea Name="ChartArea1" /></ChartAreas>
</asp:Chart>
<br />
<!-- 圖表 3:另一個簡易圖表 -->
<asp:Chart ID="Chart3" runat="server">
<Series><asp:Series Name="Series1" /></Series>
<ChartAreas><asp:ChartArea Name="ChartArea1" /></ChartAreas>
</asp:Chart>
<!-- 圖表 4:含圖例的圖表 -->
<asp:Chart ID="Chart4" runat="server">
<Legends><asp:Legend Title="金牌榜" /></Legends>
<Series><asp:Series Name="Series1" /></Series>
<ChartAreas><asp:ChartArea Name="ChartArea1" /></ChartAreas>
</asp:Chart>
</div>
</form>
</body>
</html>
在 Page_Load 中建立測試資料,並分別套用四種不同的圖表樣式:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Data;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Drawing; // 繪圖相關命名空間
public partial class chart : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
DataTable dt = CreateSampleData();
ApplyStyle1(dt); // 折線圖
ApplyStyle2(dt); // 長條圖
ApplyStyle3(dt); // 圓餅圖
ApplyStyle4(dt); // 含圖例的圖表
}
private DataTable CreateSampleData()
{
DataTable dt = new DataTable();
dt.Columns.Add("Country", typeof(string));
dt.Columns.Add("Score", typeof(int));
dt.Rows.Add("台灣", 12);
dt.Rows.Add("日本", 8);
dt.Rows.Add("韓國", 15);
dt.Rows.Add("新加坡", 5);
dt.Rows.Add("香港", 10);
return dt;
}
protected void ApplyStyle1(DataTable dt)
{
#region 折線圖
Chart1.DataSource = dt;
Chart1.Series["Series1"].ChartType = SeriesChartType.Line;
Chart1.Series[0].XValueMember = "Country";
Chart1.Series[0].YValueMembers = "Score";
Chart1.ChartAreas["ChartArea1"].AxisX.Title = "國家";
Chart1.ChartAreas["ChartArea1"].AxisX.TitleAlignment = StringAlignment.Far;
Chart1.ChartAreas["ChartArea1"].AxisY.Title = "金牌數";
Chart1.DataBind();
#endregion
}
protected void ApplyStyle2(DataTable dt)
{
Chart2.DataSource = dt;
Chart2.Series["Series1"].ChartType = SeriesChartType.Column;
Chart2.Series[0].XValueMember = "Country";
Chart2.Series[0].YValueMembers = "Score";
Chart2.ChartAreas["ChartArea1"].AxisX.Title = "國家";
Chart2.ChartAreas["ChartArea1"].AxisY.Title = "金牌數";
Chart2.DataBind();
}
protected void ApplyStyle3(DataTable dt)
{
Chart3.DataSource = dt;
Chart3.Series["Series1"].ChartType = SeriesChartType.Pie;
Chart3.Series[0].XValueMember = "Country";
Chart3.Series[0].YValueMembers = "Score";
Chart3.Series["Series1"]["PieLabelStyle"] = "Outside";
Chart3.DataBind();
}
protected void ApplyStyle4(DataTable dt)
{
Chart4.DataSource = dt;
Chart4.Series["Series1"].ChartType = SeriesChartType.Bar;
Chart4.Series[0].XValueMember = "Country";
Chart4.Series[0].YValueMembers = "Score";
Chart4.ChartAreas["ChartArea1"].AxisX.Title = "金牌數";
Chart4.ChartAreas["ChartArea1"].AxisY.Title = "國家";
Chart4.DataBind();
}
}
ChartHttpHandler 註冊會導致圖片無法顯示(出現紅叉)。DataSource、XValueMember、YValueMembers 三屬性即可快速繫結 DataTable、DataSet 或任何 IEnumerable。SeriesChartType 列舉支援 Line、Column、Bar、Pie、Bubble、Radar 等 30 種以上圖表。ChartArea、Title、Legend、Palette、BorderSkin 等屬性即可產出專業級報表視覺效果。Web.config handler 註冊、應用程式池 .NET 版本、資料夾寫入權限。EnableViewState="false"、採用資料抽樣或改用客戶端圖表庫(如 Chart.js、ECharts)。