Chart 類別

以圖形化圖表的表單顯示資料。

System.Object
  System.Web.Helpers.Chart

命名空間:  System.Web.Helpers
組件:  System.Web.Helpers (在 System.Web.Helpers.dll 中)

public class Chart

Chart 型別公開下列成員。

  名稱說明
公用方法Chart初始化 Chart 類別的新執行個體。
上層

  名稱說明
公用屬性FileName取得或設定包含圖表影像的檔案名稱。
公用屬性Height取得或設定圖表影像的高度 (像素)。
公用屬性Width取得或設定圖表影像的寬度 (像素)。
上層

  名稱說明
公用方法AddLegend將圖例新增至圖表。
公用方法AddSeries提供圖表的資料點與數列屬性。
公用方法AddTitle將標題新增至圖表。
公用方法DataBindCrossTable將圖表繫結至資料表,在資料表中,會為資料行中每一個唯一值建立數列。
公用方法DataBindTable建立數列資料並將其繫結到指定的資料表,並且選擇性地填入多個 X 值。
公用方法Equals (繼承自 Object。)
受保護的方法Finalize (繼承自 Object。)
公用方法GetBytes以位元組陣列傳回圖表影像。
公用方法靜態成員GetFromCache從快取擷取指定的圖表。
公用方法GetHashCode (繼承自 Object。)
公用方法GetType (繼承自 Object。)
受保護的方法MemberwiseClone (繼承自 Object。)
公用方法Save將圖表影像儲存至指定的檔案。
公用方法SaveToCache將圖表儲存至系統快取。
公用方法SaveXml將圖表另存為 XML 檔案。
公用方法SetXAxis設定水平軸的值。
公用方法SetYAxis設定垂直軸的值。
公用方法ToString (繼承自 Object。)
公用方法ToWebImage根據目前 Chart 物件建立一個 WebImage 物件。
公用方法Write呈現 Chart 物件的輸出做為影像。
公用方法靜態成員WriteFromCache呈現已快取為影像之 Chart 物件的輸出。
上層

此類別代表協助程式,這個協助程式簡化 ASP.NET Web Pages 中網頁程式設計的元件。您可以使用 Chart 類別,以圖形化圖表的形式顯示資料。此類別可以使用各種圖表類型 (如長條圖、直條圖和圓餅圖) 來呈現資料。如需完整的圖表類型清單,請參閱 Chart Types (Chart Controls)

Chart 類別可以用來自訂圖表的外觀。例如,您可以設定圖表的色彩、字型和框線。使用 ChartTheme 類別以快速設定圖表的佈景主題。佈景主題是指定如何使用字型、色彩、標籤、調色盤、框線和效果來呈現圖表的資訊集合。如需設定圖表佈景主題的相關資訊,請參閱 Displaying Data in a Chart 中的「設定圖表樣式」一節。

為了協助降低建立圖表的潛在效能影響,您可以在第一次使用圖表時儲存圖表,以建立圖表。當您需要再次顯示該圖表時,可以擷取儲存的版本並呈現該版本,而不需要重新產生圖表。您可以使用下列其中一種方法來儲存圖表:

  • 以快取項目的形式。

  • 以影像檔的形式。

  • 以 XML 檔案的形式。

如需儲存圖表的相關資訊,請參閱 Displaying Data in a Chart 中的「儲存圖表」一節。

下列範例顯示如何使用 Chart 類別,以根據值的陣列來建立圖表影像。

@{ 
    var basicChart = new Chart(width: 600, height: 400) 
        .AddTitle("Chart Title") 
        .AddSeries( 
            name: "Employee", 
            xValue: new[] {  "Peter", "Andrew", "Julie", "Mary", "Dave" }, 
            yValues: new[] { "2", "6", "4", "5", "3" }) 
        .Write(); 
}

下列範例顯示如何使用 Chart 類別,透過執行資料庫查詢,然後從查詢結果繫結選取的資料,以建立圖表影像。

@{ 
    var db = Database.Open("SmallBakery"); 
    var data = db.Query("SELECT Name, Price FROM Product"); 
    var basicChart = new Chart(width: 600, height: 400) 
        .AddTitle("Product Sales") 
        .DataBindTable(dataSource: data, xField: "Name") 
        .Write(); 
}

這個型別的任何公用 static (在 Visual Basic 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。
顯示: