ASP.NET進度條控制項(即時)（二）

ASP.NET進度條控制項（二）

 AntarDev ProgressBar 進度條控制項1.0測試版發布

控制項名稱:ProgressBar

控制項類型:ASP.NET2.0伺服器控制項

開 發 者:bingdian3721@gmail.com

命名空間:AntarDev

類 名 稱:ProgressBar

目前的版本:0.2.2.0

說   明 :本程式只能用於學習和測試用途,請勿用於商業用途

 

本控制項使用XMLHTTP組件在瀏覽器端非同步請求進度條即時資料，同時由特定的Http Module進行快速響應，不會因為使用者的高負載操作而輕易失去響應，或者阻塞。可以根據不同的使用情境對進度條進行適當調整以完成即時進度顯示任務。

與以前的版本相比，改進的地方很多。

1． 自動設定Web.Config，無需手工添加Http模組的引用。

2． 增加了百分比屬性，方便設定進度。

3． 發布的程式集附帶XML注釋，可以有效利用智能感知，方便代碼編寫。

4． 改變了以往用靜態方法設定進度條屬性的設計，增加了ProgressBarController控制類，可以方便的串連到進度條，並進行進度設定等任務。

5． 進度條頁面和設定進度條的方法之間，使用進度條唯一標識SN進行通訊，只要掌握了SN，不論在什麼地方，都可以通過ProgressBarController類串連到進度條，進行操作。

6． 增加了服務端的Begin方法。

7． 修正了幾個小bUG。

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

 

基本類型

public enum ProgressBarWorkLevel 用於聲明控制項的工作層次

取值	說明
Application	控制項的執行個體用於應用程式層級，訪問該進度條的使用者共用一個進度條執行個體。
PageVisit	控制項的執行個體用於頁面存取層級，每個使用者獨享一個進度條的執行個體。

 

ProgressBar控制項屬性列表

名稱	說明	預設值
AutoBegin	進度條是否自動開始	false
AutoHidden	進度條自動隱藏。當沒有啟動之前和完成進度之後自動隱藏，只有在走進度過程中顯示。	false
BackColor	背景色	Gainsboro
BackImage	進度條背景映像(優先於背景色)
BeginFromZero	進度條在瀏覽器端初始值為0，不受設計時Value值影響	true
BorderColor	進度條邊框顏色	Gray
BorderWidth	進度條邊框寬度	1px
ForeColor	前景色彩	RoyalBlue
ForeImage	進度條前景映像(優先於前景色彩)
FullAutoComplete	進度條走完進度後停止變動，並觸發onComplete事件指令碼	false
Height	高度(進度條提示文本高度不計算在內)	20px
Interval	進度條更新間隔，以毫秒為單位	1000
Maximum	進度條所使用的範圍的上限	100
Minimum	進度條所使用的範圍的下限	0
onComplete	進度條停止變動後執行的JavaScript
onError	進度條出現錯誤後執行的JavaScript,這裡的錯誤指的是通訊類錯誤
Percentage	當前百分比	0
SN	進度條唯一標識[當工作在application模式時等於ID]
Text	進度條上方顯示的提示文本
TextAlign	提示文本對齊	HorizontalAlign.NotSet
TextColor	提示文本的顏色	Black
Value	當前值	0
Width	寬度	400px
WorkLevel	進度條工作層次	ProgressBarWorkLevel.PageVisit

 

ProgressBarController類：
進度條控制類，允許串連到正在啟動並執行進度條，對其進行操作

建構函式

public ProgressBarController(string SN)
功能：初始化ProgressBarController的新執行個體
參數：進度條的唯一標識

屬性列表

名稱	說明
Value	擷取或設定進度條當前值
Text	擷取或設定進度條顯示的文本
Percentage	擷取或者設定進度百分比(大於等於0且小於等於1)
Maximum	擷取進度條所使用範圍的上限
Minimum	擷取進度條所使用範圍的下限

 

方法列表

名稱	說明
End	結束一個進度條的生存周期,並銷毀相關資料

 

例子：

        AntarDev.ProgressBarController npc = new AntarDev.ProgressBarController("sn");

        npc.Value += 1;

        npc.Percentage = 0.20;

        npc.Text = "當前進度20％";

 

其中”sn”這個字串，在實際使用過程中，應該傳遞一個ProgressBar的SN屬性到這裡來。

 

 

控制項：http://www.antardev.cn/ProgressBar0.2.2.0.rar

測試程式地址：http://www.antardev.cn/TW0.2.2.0.rar

注意：早先版本不再提供下載，如果特殊需要，直接與我聯絡。