VisualStudio 开发 WebPart 之公开属性

WebPart 可以公开一些属性,这些属性可以由用户直接在 WebPart 的属性面板中编辑。任何一个 WebPart 类的公共属性只要添加两个特性类即可启用它的页面编辑。下面是 WebPart 的属性代码:

private string _WebPartProperty1;
[Personalizable(true)] //此特性表示允许此属性个性化
[WebBrowsable] //此特性表示此属性显示到编辑面板中
public string WebPartProperty1
{
    get{return _WebPartProperty1;}
    set{_WebPartProperty1 = value;}
}
  

除此之外,WebPart 属性还支持其他的特性,所有特性如下:

  • PersonalizableAttribute : 指定属性是否个性化
  • WebBrowsableAttribute : 指定属性是否可以在面板中编辑
  • WebDisplayNameAttribute : 指定属性在属性面板中编辑时的名称
  • CategoryAttribute : 指定属性的分组
  • ConnectionProviderAttribute : 声明 WebPart 连接提供者
  • ConnectionConsumerAttribute : 声明 WebPart 连接使用者

WebPart 的个性化属性分为共享属性和用户属性,共享属性可以由管理员统一配置,影响到所有的用户。私有属性可以由个人配置,即每个用户可以控制自己使用的 WebPart 的属性,通过指定 PersonalizableAttributePersonalizationScope 可以控制属性个性化的范围,WebPart 个性化属性代码如下:

private string _WebPartProperty2;
[Personalizable(PersonalizationScope.Shared)] //这是一个共享属性
[WebBrowsable(true)]
public string WebPartProperty2
{
    get{return _WebPartProperty2}
    set{_WebPartProperty2 = value;}
}
private string _WebPartProperty3;
[Personalizable(PersonalizationScope.User)] //这是一个用户属性
[WebBrowsable(true)]
public string WebPartProperty3
{
    get{return _WebPartProperty3}
    set{_WebPartProperty3 = value;}
}