萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET Microsoft Chart 控件完整使用指南與範例代碼

前言

ASP.NET 內建的 Microsoft Chart 控件(System.Web.UI.DataVisualization.Charting)提供了強大的資料視覺化功能,支援多種圖表類型、豐富的樣式設定以及資料繫結。本文將透過完整的範例,示範如何在 ASP.NET Web Forms 專案中正確設定並使用 Chart 控件繪製統計圖表。

一、Web.config 組態設定

使用 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 頁面標記

在 .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>

三、後端 C# 程式碼

在 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 等屬性即可產出專業級報表視覺效果。

五、常見問題排查

  1. 圖片不顯示:檢查 Web.config handler 註冊、應用程式池 .NET 版本、資料夾寫入權限。
  2. 中文亂碼:確保標題、座標軸標題字型支援中文(如「微軟雅黑」),並將檔案儲存為 UTF-8。
  3. 效能考量:大量資料點建議啟用 EnableViewState="false"、採用資料抽樣或改用客戶端圖表庫(如 Chart.js、ECharts)。
copyright © 萬盛學電腦網 all rights reserved