webpart属性
以下是自定义webpart属性时的常见特性:
一、当webpart继承自Microsoft.SharePoint.WebPartPages.WebPart时常用的属性:
Browsable(true), _ '是否在Panel中可见
Category("Miscellaneous"), _ ' 所属类别,大部分sharepoint中自带的webpart都有外观、布局、高级这三项分类。使用Category可以自定义属性。如果不定义此项,默认会被显示在“杂项(Miscellaneous)"组中。
DefaultValue(defaultText),_ '默认值,
WebPartStorage(Storage.Personal), _ '该属性的应用范围。枚举Storage.Shared(该属性只能在共享视图中使用),Storage.Personal(默认值,关于页面的共享视图和个人视图),Storage.None(该属性在两种视图中都不可用)
FriendlyName("Text"), _ '显示在Panel中的名称
Description("WebPart1") '描述,也就是当鼠标停在控件上时显示的名称。
ReadOnly'该属性是否为只读属性。
二、当webpart继承自System.Web.UI.WebControls.WebParts.WebPart时常用的属性:
Personalizable,//必需项,标识一个属性是自定义属性
WebBrowsable,//必需项,标识这个属性是否会显示在属性编辑界面中。
WebDisplayName(),//在参数中可以自定义属性的友好名称。
WebDescription(),//描述,也就是当鼠标停在控件上时显示的名称。
-
WebPart生命周期.
当一个包含WebPart的WSS站点页面被响应请求或者是它被提交到Server端的时候,这时WebPart生存周期开始了
-
OnInit 初始化,加载相关配置文件 (如WebPart任务面板上的属性,样式等配置信息) .
-
LoadViewState 返回先前最后一次被处理的状态(如webpart是展现,隐藏还是关闭)
-
CreateChildControls 创建WebPart UI ,通过Controls.Add()方法装载Web 控件(Note:当Webpart是第一次展现的时候CreateChildControls方法发生在OnLoad方法之前,而经过一次postback之后,它发生在OnLoad方法之后)
-
OnLoad 从数据库或者其他系统重新获取要展现的数据(如获取数据库连接)
-
User-Generated Events 响应用户生成事件(如Button Click)
-
RendenContents 生成 html output,实现最终的UI展现 (由HTMLTextWriter class 来实现)
-
SaveViewState 保存控件状态 (ViewState 被序列化之后保存在一个hidden field 里)
-
Dispose 从内存中移除对象,释放临界资源(如释放数据库连接)
-
OnUnLoad 最终完成内存清除工作