控件名稱:ProgressBar
控件類型:ASP.NET2.0服務(wù)器控件
開 發(fā) 者:bingdian3721@gmail.com
命名空間:AntarDev
類 名 稱:ProgressBar
當(dāng)前版本:0.2.2.1[2008-9-4]

說    明:未經(jīng)本人許可,本程序只能用于學(xué)習(xí)和測試用途,請勿用于商業(yè)用途

本控件使用XMLHTTP組件在瀏覽器端異步請求進(jìn)度條實時數(shù)據(jù)，同時由特定的Http Module進(jìn)行快速響應(yīng)，不會因為用戶的高負(fù)載操作而輕易失去響應(yīng)，或者阻塞。可以根據(jù)不同的使用場景對進(jìn)度條進(jìn)行適當(dāng)調(diào)整以完成實時進(jìn)度顯示任務(wù)。
與以前的版本相比，改進(jìn)的地方很多。
1． 自動配置Web.Config，無需手工添加Http模塊的引用。
2． 增加了百分比屬性，方便設(shè)置進(jìn)度。
3． 發(fā)布的程序集附帶XML注釋，可以有效利用智能感知，方便代碼編寫。
4． 改變了以往用靜態(tài)方法設(shè)置進(jìn)度條屬性的設(shè)計，增加了ProgressBarController控制類，可以方便的連接到進(jìn)度條，并進(jìn)行進(jìn)度設(shè)置等任務(wù)。
5． 進(jìn)度條頁面和設(shè)置進(jìn)度條的方法之間，使用進(jìn)度條唯一標(biāo)識SN進(jìn)行通信，只要掌握了SN，不論在什么地方，都可以通過ProgressBarController類連接到進(jìn)度條，進(jìn)行操作。
6． 增加了服務(wù)端的Begin方法。
7． 修正了幾個小bUG。

注意:
同時在使用PageVisit工作層次時，需要啟用Session。

 
基本類型
public enum ProgressBarWorkLevel 用于聲明控件的工作層次
取值 說明
Application 控件的實例用于應(yīng)用程序級別，訪問該進(jìn)度條的用戶共享一個進(jìn)度條實例。
PageVisit 控件的實例用于頁面訪問級別，每個用戶獨享一個進(jìn)度條的實例。

 
ProgressBar控件屬性列表
名稱 說明 默認(rèn)值
AutoBegin 進(jìn)度條是否自動開始 false
AutoHidden 進(jìn)度條自動隱藏。當(dāng)沒有啟動之前和完成進(jìn)度之后自動隱藏，只有在走進(jìn)度過程中顯示。 false
BackColor 背景色 Gainsboro
BackImage 進(jìn)度條背景圖像(優(yōu)先于背景色)  
BeginFromZero 進(jìn)度條在瀏覽器端初始值為0，不受設(shè)計時Value值影響 true
BorderColor 進(jìn)度條邊框顏色 Gray
BorderWidth 進(jìn)度條邊框?qū)挾?1px
ForeColor 前景色 RoyalBlue
ForeImage 進(jìn)度條前景圖像(優(yōu)先于前景色)  
FullAutoComplete 進(jìn)度條走完進(jìn)度后停止變動，并觸發(fā)onComplete事件腳本 true
Height 高度(進(jìn)度條提示文本高度不計算在內(nèi)) 20px
Interval 進(jìn)度條更新間隔，以毫秒為單位 1000
Maximum 進(jìn)度條所使用的范圍的上限 100
Minimum 進(jìn)度條所使用的范圍的下限 0
onComplete 進(jìn)度條停止變動后執(zhí)行的JavaScript  
onError 進(jìn)度條出現(xiàn)錯誤后執(zhí)行的JavaScript,這里的錯誤指的是通訊類錯誤  
Percentage 當(dāng)前百分比 0
SN 進(jìn)度條唯一標(biāo)識[當(dāng)工作在application模式時等于ID]  
Text 進(jìn)度條上方顯示的提示文本  
TextAlign 提示文本對齊方式 HorizontalAlign.NotSet
TextColor 提示文本的顏色 Black
Value 當(dāng)前值 0
Width 寬度 400px
WorkLevel 進(jìn)度條工作層次 ProgressBarWorkLevel.PageVisit

 
ProgressBarController類：
進(jìn)度條控制類，允許連接到正在運行的進(jìn)度條，對其進(jìn)行操作

構(gòu)造函數(shù)
public ProgressBarController(string SN)
功能：初始化ProgressBarController的新實例
參數(shù)：進(jìn)度條的唯一標(biāo)識

屬性列表

名稱 說明
Value 獲取或設(shè)置進(jìn)度條當(dāng)前值
Text 獲取或設(shè)置進(jìn)度條顯示的文本
Percentage 獲取或者設(shè)置進(jìn)度百分比(大于等于0且小于等于1)
Maximum 獲取進(jìn)度條所使用范圍的上限
Minimum 獲取進(jìn)度條所使用范圍的下限

 
方法列表
名稱 說明
End 結(jié)束一個進(jìn)度條的生存周期,并銷毀相關(guān)數(shù)據(jù)

 
例子：

        AntarDev.ProgressBarController npc = new AntarDev.ProgressBarController("sn");
        npc.Value += 1;
        npc.Percentage = 0.20;
        npc.Text = "當(dāng)前進(jìn)度20％";
 
其中”sn”這個字符串，在實際使用過程中，應(yīng)該傳遞一個ProgressBar的SN屬性到這里來。
 
 
控件下載地址：http://www.antardev.cn/ProgressBar0.2.2.1.rar
測試程序地址：http://www.antardev.cn/TW0.2.2.1.rar
注意：早先版本不再提供下載，如果特殊需要，直接與我聯(lián)系。
 
 
 FullAutoComplete屬性的默認(rèn)值為true

• asp