WebPart实例教程

WebPartManager 控件
Web Parts的总控中心
管理 Web Parts及区域的列表
管理页面状态 (比如显示状态)，当页面状态时发生改变时触发事件
协助Web Parts间的通讯
管理个性化等

< asp:WebPartManager  ID ="WebPartManager1"  RunAt ="server"   />

WebPartZone 控件
在 Web Parts页面中定义区域
定义每个区域当中Web Part的默认显示样式及布局

< asp:WebPartZone  ID ="WeatherZone"
DragHighlightColor ="244,198,96"  RunAt ="server" >
< PartTitleStyle  BackColor ="#2254B1"  ForeColor ="White"   />
< PartStyle  BorderColor ="#81AAF2"  BorderStyle ="Solid"  BorderWidth ="1px"   />
< ZoneTemplate >
<!--  Web Parts declared here  -->
</ ZoneTemplate >
</ asp:WebPartZone >

Web Part Chrome
标题框及Web Part的边框
通过 WebPartZone 定义其外观

Web Parts
在 WebPartZone中定义的控件
Web controls, user controls, custom controls
未实现IWebPart接口的控件将封装进GenericWebParts
增加以下属性: Title, Description, etc.

< ZoneTemplate >
< asp:Calendar  Title ="Calendar"  ID ="Calendar1"  RunAt ="server"   />
< user:Weather  Title ="Weather"  ID ="Weather1"  RunAt ="server"   />
< custom:Search  Title ="Search"  ID ="Search1"  RunAt ="server"   />
</ ZoneTemplate >

WebPartManager.DisplayMode
设置或者获取页面的显示模式
BrowserDisplayMode “正常的” 显示模式，无法编辑（默认）
DesignDisplayMode 允许拖拽式布局编辑
EditDisplayMode 允许编辑Web Part的外观及行为
CatalogDisplayMode 允许将Web Part添加在另外的页面上
ConnectDisplayMode 允许Web Parts之间进行通讯

DisplayMode 事件
WebPartManager.DisplayModeChanging
指示显示模式是否要发生改变
WebPartDisplayModeCancelEventArgs 获得新的显示模式并且允许控制者取消这种改变
WebPartManager.DisplayModeChanged
指示显示模式是否已经发生改变
WebPartDisplayModeEventArgs 得到原来的显示模式

其它的区域类型
WebPartZones 定义基本的页面显示内容
在任何时间均显示
其它区域允许页面可以被编辑
根据显示模式有条件得进行显示
CatalogZone 允许用户在页面上添加Web Part
EditorZone 允许用户更改Web Part的属性及布局
ConnectionsZone 允许用户建立Web Part之间的通讯

CatalogZone 控件
允许Web Part可以交互式的进行添加
包含一个或者多个 CatalogPart 控件
PageCatalogPart 显示页面上已经删除的Web Part的列表
DeclarativeCatalogPart 显示声明在 <WebPartsTemplate>中的Web Part的列表
ImportCatalogPart 允许从 .WebPart文件中导入的Web Part

声明 CatalogZone

< asp:CatalogZone  ID ="CatalogZone1"  Runat ="server" >
< ZoneTemplate >
< asp:PageCatalogPart  ID ="PageCatalogPart1"  Runat ="server"   />
< asp:DeclarativeCatalogPart  ID ="DeclarativeCatalogPart1"  Runat ="server" >
< WebPartsTemplate >
<!--  Declarative Web Parts go here  -->
</ WebPartsTemplate >
</ asp:DeclarativeCatalogPart >
< asp:ImportCatalogPart  ID ="ImportCatalogPart1"  Runat ="server"   />
</ ZoneTemplate >
</ asp:CatalogZone >

EditorZone控件
允许交互式的对 Web parts进行更改
包含一个或者多个 EditorPart 控件
AppearanceEditorPart 提供修改标题及其它界面相关属性的UI
BehaviorEditorPart 提供修改行为属性的UI
LayoutEditorPart 提供修改Web Part的显示状态，区域及区域索引的UI
PropertyGridEditorPart 提供修改定制属性的UI
声明 EditorZone

< asp:EditorZone  ID ="EditorZone1"  Runat ="server" >
< ZoneTemplate >
< asp:AppearanceEditorPart  ID ="AppearanceEditorPart1"  Runat ="server"   />
< asp:BehaviorEditorPart  ID ="BehaviorEditorPart1"  Runat ="server"   />
< asp:LayoutEditorPart  ID ="LayoutEditorPart1"  Runat ="server"   />
</ ZoneTemplate >
</ asp:EditorZone >

PropertyGridEditorPart
允许修改自定义属性的UI
显示标记为 [WebBrowsable]的属性

string  _stocks;  //  e.g., "MSFT,INTC,AMZN"

[WebBrowsable]
public   string  Stocks
 {
    get { return _stocks; }
    set { _stocks = value; }
 }

Web Part 通讯
Web Parts可以相互通讯
提供者发布接口
订阅者通过接口获得数据
WebPartManager 管理通讯
从提供者获得接口
向订阅者发布接口
通讯可以是静态的，也可以是动态的
ConnectionsZone 提供后期绑定的UI

通讯提供者
实现方法返回接口
方法特性 [ConnectionProvider]

[ConnectionProvider ( " Zip Code " ,  " ZipCodeProvider " )]
public  IZipCode GetZipCodeInterface ()
 {
     return this; // Assumes control implements IZipCode
 }

//  IZipCode.GetZipCode implementation
public   string  GetZipCode ()
 {
    return _zip;
 }

通讯订阅者
实现方法接收接口参数
方法特性 [ConnectionConsumer]

[ConnectionConsumer ( " Zip Code " ,  " ZipCodeConsumer " )]
public   void  GetIZipCodeInterface (IZipCode provider)
 {
    string zip = provider.GetZipCode (); // Get zip code from provider
 }

静态通讯方式
在 WebPartManager的 <StaticConnections> 元素中定义
最终用户无法修改
<asp:Connection>的实例

< asp:WebPartManager ID = " WebPartManager1 "  Runat = " server " >
< StaticConnections >
< asp:Connection ID = " ZipCodeConnection "  Runat = " server "
ProviderID = " Weather1 "  ProviderConnectionPointID = " ZipCodeProvider "
ConsumerID = " News1 "  ConsumerConnectionPointID = " ZipCodeConsumer "   />
</ StaticConnections >
</ asp:WebPartManager >

ConnectionsZone 控件
提供供Web Part进行通讯的UI
最终用户，而不是开发人员创建通讯关系
<asp:ConnectionsZone ID="ConnectionsZone1"
Runat="server" />

Web Parts 个性化
Web Parts 个性化服务
自动保存相关Web Part的属性 (布局, 外观等等)
自动保存标记为 PersonalizableAttribute的定制属性
PersonalizationAdministration 类
提供个性化服务的API
Provider-based for flexible data storage
Per-User 个性化
[Personalizable] 为每位用户保存定制属性

string  _stocks;  //  e.g., "MSFT,INTC,AMZN"

[WebBrowsable]
[Personalizable]
public   string  Stocks
 {
    get { return _stocks; }
    set { _stocks = value; }
 }

Shared Personalization
[Personalizable (PersonalizationScope. - Shared)] persists properties on shared basis
string  _stocks;  //  e.g., "MSFT,INTC,AMZN"

[WebBrowsable]
[Personalizable (PersonalizationScope.Shared)]
public   string  Stocks
 {
    get { return _stocks; }
    set { _stocks = value; }
 }

个性化服务是基于Provider模式
使用 SQL Server Provider

< configuration >
< system.web >
< webParts >
< personalization  defaultProvider ="AspNetSqlPersonalizationProvider"   />
</ webParts >
</ system.web >
</ configuration >

定制Web Parts
任何控件均可以作为Web Parts来运行，但…
Controls that derive from WebPart can better leverage the Web Parts infrastructure
控件标题及其它与UI相关的属性
控件的AllowClose, AllowZoneChange, AllowMinimize, 以及其它行为属性
应用基于角色的安全特性 (授权方式)
增加自定义操作，导出Web Part以及更多..
增加自定义操作

public   class  MyWebPart : WebPart
 {
    public override WebPartVerbCollection Verbs
    {
        get {
            EnsureChildControls ();
            WebPartVerb verb = new WebPartVerb (new WebPartEventHandler (OnClearResults));
            verb.Text = "Clear Results";
            WebPartVerb[] verbs = new WebPartVerb[] { verb };
            return new WebPartVerbCollection (base.Verbs, verbs);
            }
    }

    void OnClearResults (object sender, WebPartEventArgs args) {  }
    
      
 }

导出Web Part
WebPart.ExportMode属性
WebPartExportMode.None (默认)
WebPartExportMode.All
WebPartExportMode.NonSensitiveData
“All” 及 “NonSensitiveData” 增加导出操作以便Web Part可以被导出
仅[Personalizable] 属性
PersonalizableAttribute.IsSensitive识别 “sensitive” 属性
导出所有属性

public   class  MyWebPart : WebPart
{
    public MyWebPart ()
   {
        ExportMode = WebPartExportMode.All;
    }
    
}

导出所选择的属性

public   class  MyWebPart : WebPart
{
    public MyWebPart ()
    {
        ExportMode = WebPartExportMode.NonSensitiveData;
    }

    // This property will be exported
    [Personalizable (PersonalizationScope.User, false)]
    public string ZipCode
    {  }

    // This one will not
    [Personalizable (PersonalizationScope.User, true)]
    public string SocialSecurityNumber
    {  }
    
}