ASP.NET进度条控件(实时)（二）

ASP.NET进度条控件（二）

控件名称: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的新实例
参数：进度条的唯一标识

属性列表

方法列表

名称	说明
End	结束一个进度条的生存周期,并销毁相关数据

例子：

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

npc.Value += 1;

npc.Percentage = 0.20;

npc.Text = "当前进度20％";

其中”sn”这个字符串，在实际使用过程中，应该传递一个ProgressBar的SN属性到这里来。

注意：早先版本不再提供下载，如果特殊需要，直接与我联系。

秒客网