WebForms

TeeChart是通過WebChart TeeChart控件與WebForms集成的。WebChart可以在標準TeeChart.NET中文版安裝中的工具箱中找到。

TooBox中WebChart的圖標

向窗體添加一個圖表

• 在ToolBox中選擇WebChart組件并拖拽到WebForm上，然后調(diào)整它的大小
• 右擊圖表選擇“Edit...”選項從而打開圖表編輯器
• 使用圖表編輯器您可以添加和修改數(shù)據(jù)序列、坐標軸以及圖表的其它特性。

使用圖表編輯器和屬性選項來進行設(shè)計

圖表編輯器提供了多種選項來配置圖表在運行時的很多問題。設(shè)置會被保存到WebForm。請參閱關(guān)于圖表編輯器使用的教程1和教程2，WebChart編輯器的使用與基于圖表的Windows窗體的使用是完全相同的。

圖像格式（PictureFormat）

WebChart就像一張圖片顯示在WebForm上，默認的格式是PNG，但您可以在Properties Windows中通過PictureFormat屬性來進行修改。由于網(wǎng)頁的一致性，我們推薦使用PNG，JPEG或者GIF格式，盡管Internet Explorer也支持Bitmap格式。

使用GIF圖像格式

相對于全部彩色復制，GIF使用了256色的縮小，所以我們建議您使用其它圖像格式的一種。

TempChart屬性可以用來選擇臨時圖表創(chuàng)建后及在網(wǎng)頁上顯示前的保存方式。這里有4個可用的設(shè)置：

• File
• Session
• Cache
• Httphandler

性能與所有的緩存技術(shù)是類似的，但磁盤性能可能會積極地或消極地影響使用'File'選項來產(chǎn)生TempChart，所以‘File’是最快的選擇。

File

如果你想要把臨時文件寫到磁盤上，那么就可以使用File設(shè)置。默認情況下，TeeChart安裝時就創(chuàng)建了關(guān)于臨時文件位置的注冊表鍵值和虛擬文件夾的名稱。注冊表鍵值如下所示：

[HKEY_LOCAL_MACHINE\SOFTWARE\Steema Software\TeeChart.NET]

"VirtualShare"="/TeeChartForNET"

"ShareFolder"="C:\\Program Files\\Steema Software\\TeeChart for .NET v3\\TeeChartForNET"

如果接受默認的安裝位置，以上設(shè)置是在標準的英語語言機器上所創(chuàng)建的。TeeChartNET虛擬文件夾是被TeeChart安裝文件建立的。您可以更改這些注冊表設(shè)置的前提是你創(chuàng)建必要的IIS虛擬共享位置，以反映新的注冊表值。

WebChart把文件保存到ShareFolder注冊表鍵值下一個名為_Chart_tmp的文件夾中。

臨時文件不會被TeeChart刪除，雖然一個應用程序可能會像Windows預設(shè)任務(wù)一樣自動的為你這樣做，請檢查當前版本TeeChar所含內(nèi)容。

Session

Session是一個在磁盤上不留下任何文件的臨時文件存儲的設(shè)置，并刪除自己已緩存的內(nèi)存文件（也可參閱見Cache和HttpHandler選項）。在某些情況下，你可能會發(fā)現(xiàn)它略慢于臨時磁盤文件。圖表能夠成功運行Session變量，有兩個條件必須為真：

• Session必須被應用程序激活。‘Enabled’是默認的方式，您可以在項目中的web.config文件中進行確認：

 &nbsp;  <sessionState  

   mode="InProc"

InProc是默認的設(shè)置并且意味著Session已經(jīng)被應用程序激活。

• 您需要包含一個aspx script模塊來從Memory中檢索圖表。aspx script的名稱可以稱為‘GetChart’。一個包含TeeChart發(fā)布的WebForm ASP.NET的例子，要從頭創(chuàng)建一個新的GetChart模塊需要在您的項目中添加一個新的WebForm（或者是任何aspx文件）命名為'GetChart'并將下面的代碼添加到Page_Load事件中：

   

  GetChart.aspx.cs

          private void Page_Load(object sender, System.EventArgs e)

          {

              string chartName=Request.QueryString["Chart"];

   

    ;          if (Session[chartName]!=null)

   &nbsp; &nbsp;        {

          &nbsp;       System.IO.MemoryStream chartStream = new System.IO.MemoryStream();

     ;             chartStream=((System.IO.MemoryStream)Session[chartName]);

                  Response.ContentType = "image/" + "png";

                  Response.OutputStream.Write(chartStream.ToArray(),0,(int)chartStream.Length);

       &nbsp;       &nbsp;  chartStream.Close();

               &nbsp;  Session.Remove(chartName);

              }

          }

  該腳本恢復了事先已經(jīng)被WebChart保存到Session緩存的圖表，該腳本不僅向瀏覽器返回了圖表而且從緩存中移除了圖表。

  Cache

  Cache選項與安裝到Session Chart緩存選項十分相似。'Cache'是一個實用的選項，因為它使用的緩存對象屬于ASP.NET WebForm頁面。鑒于'Session'會受到某些Web Servers的限制，因此使用Cache很容易對大多數(shù)ASP.NET應用程序進行配置（如在管理員選擇出于安全原因禁用會話支持）。

  Cache選項要求使用GetChart.aspx文件。

• 您需要包含一個aspx script模塊來從Memory中檢索圖表。aspx script的名稱可以稱為‘GetChart’。一個包含TeeChart發(fā)布WebForm ASP.NET的例子的例子。要從頭創(chuàng)建一個新的GetChart模塊需要在您的項目中添加一個新的WebForm（或者是任何aspx文件）命名為'GetChart'并將下面的代碼添加到Page_Load事件中：

  GetChart.aspx.cs

    &nbsp;     private void Page_Load(object sender, System.EventArgs e)

          {

    &nbsp;         string chartName=Request.QueryString["Chart"];

        &nbsp;     if (Page.Cache[chartName]!=null)

           &nbsp;  {

                  MemoryStream chartStream = new MemoryStream();

      &nbsp;           chartStream=((MemoryStream)Page.Cache[chartName]);

                  Response.ContentType = &quot;image/" + "png";

                  Response.OutputStream.Write(chartStream.ToArray(),0,(int)chartStream.Length);

            &nbsp;     chartStream.Close();

            ;  }

  該腳本恢復了事先已經(jīng)被WebChart保存到Page Cache的圖表，該腳本不僅向瀏覽器返回了圖表而且從緩存中移除了圖表。

  Httphandler

  HttpHandler選項使用內(nèi)部的TeeChart（WebChart）生成器恢復該頁的圖表圖像。這個選項不需要產(chǎn)生任何臨時文件以及附加的aspx文件來恢復圖表（在Session和Cache的情況下）。該選項只需要對web.config文件做一個修改：

  在web.config的<system.web> </system.web>標簽中的任何位置假如以下部分：

  <system.web>

    <httpHandlers>

         <add verb="*" path="TeeChartImgGen.ashx" type="Steema.TeeChart.Web.TeeChartImgGen, TeeChart"/>

    </httpHandlers>

  /*..content cut for brevity ..*/

  </system.web>

  使用交互式圖表事件（當Chart沒有WebChart Tools時，AutoPostBack屬性為True）

  圖表中的Load事件和在運行時響應用戶鼠標點擊的交互事件可能用于TeeChart的WebChart。沒有特別的動作需要使用繪制事件如'AfterDraw'，我們可以從屬性瀏覽器的事件列表來選擇一個圖表事件。如果沒有TeeChart WebChart Tool如Zoom，Scroll或者Hotspot顯示在圖表中，您需要設(shè)置AutoPostback屬性為True來激活交互（用戶點擊）事件。對于交互事件，如果上述Tools是當前點擊自動激活的反應，圖表將響應用戶的鼠標點擊事件，回發(fā)在哪里發(fā)生的點擊的信息到服務(wù)器，于是你的服務(wù)器端代碼可以采取針對該事件的行動。你可以從屬性瀏覽器的事件列表選擇想要使用的事件，然后對該事件進行編碼。

  參閱&lsquo;Event example’教程獲取更多關(guān)于WebChart事件的信息。

  事件舉例

  如果您想要在WebChart中使用一個Click事件如ClickSeries，請確認圖表的AutoPostback設(shè)置為True。

  事件可以通過雙擊在屬性瀏覽器事件列表中需要的事件來進行設(shè)置：

  

  雙擊列表中的一個條目創(chuàng)建代碼事件的聲明。

  例子

          private int xVal;

       ;   private int yVal;

          private void WebChart1_AfterDraw(object sender, Steema.TeeChart.Drawing.Graphics3D g)

          {

              g.TextOut(xVal,yVal,"onAfterDraw&quot;);

          }

  上述事件將輸出文字到圖表上的一個由xVal和yVal變量值決定的位置

   

  根據(jù)點擊的位置來設(shè)置x和y的值。

          private void WebChart1_ClickSeries(object sender, Steema.TeeChart.Series s, int valueIndex, System.EventArgs e)

          {

              xVal=s.CalcXPos(valueIndex);

          &nbsp;   yVal=s.CalcYPos(valueIndex);    

          }