English(beta)
hfyb的Blog 页面正在加载中 .....

使用Web Part创建个性化的ASP.NET 2.0应用程序

Web Parts 是Microsoft Visual Studio 2005 中的ASP.NET 2.0的新特性之一,Web Parts是构建类门户风格(Portal-Style)的应用的框架,它继承自SharePoint Portal Server的成熟模式,可以用最小的代码创建更丰富的表现,如用户可以使用拖拽的方式创建页面布局等。与它有关的控件都在System.Web.UI.WebControls.WebParts这个命名空间里。

  1. WebPartManager控件

    WebPartManager是Web Parts的总控中心。它可以管理Web Parts及区域的列表;管理页面状态,当页面状态改变时触发事件;协助Web Parts间的通讯;管理个性化等。
    每个页面仅有一个WebPartsManager实例,没有UI。

    1. <asp:WebPartManager ID="WebPartManager1" runat="server" />

     

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

    DisplayMode事件
    当DisplayMode发生改变时,会触发WebPartManager.DisplayModeChanging事件,其参数WebPartDisplayModeCancelEventArgs获得新的显示模式,并且允许控制者取消这种改变。
    当DispalyMode已经发生改变,会触发WebPartManager.DisplayModeChanged事件,其参数WebPartDispalyModeEventArgs得到原来的显示模式。

  2. WebPartZone控件

     

    WebPartZone是在Web Parts页面中定义的区域,它定义每个区域中的Web Part的默认显示样式及布局。

    1. <asp:WebPartZone ID="WebPartZone1" runat="server">
    2.  <ZoneTemplate>
    3.  </ZoneTemplate>
    4. </asp:WebPartZone>

     

    Web Part Chrome则是Web Part的标题栏及边框,它是通过WebPartZone来定义其外观和操作的。

    在WebPartZone中可以定义各种控件如:Web controls, user controls, custom controls等等。未实现IWebPart接口的控件将封装进GenericWebParts,而且需要增加以下的属性,如Title, Description等。

  3. CatalogZone控件

     

    PageCatalogPart: 显示页面上已经删除的Web Part的列表
    DeclarativeCatalogPart: 显示声明在中的Web Part列表
    ImportCatalogPart: 允许.WebPart文件中导入的Web Part

    1. <asp:CatalogZone ID="CatalogZone1" runat="server">
    2.  <ZoneTemplate>
    3.   <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    4.   <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" runat="server">
    5.    <WebPartsTemplate>
    6.     <asp:Button ID="Button1" runat="server" Text="Button" />
    7.    </WebPartsTemplate>
    8.   </asp:DeclarativeCatalogPart>
    9.  </ZoneTemplate>
    10. </asp:CatalogZone>

     

    CatalogZone控件允许Web Part可以交互式的进行添加,可以包含一个或多个CatalogPart控件。
  4. EditorZone控件

     

    AppearanceEditorPart: 提供修改标题即其它界面相关属性的
    UIBehaviorEditorPart: 提供修改行为属性的
    UI LayoutEditorPart: 提供修改Web Part的显示状态,区域及区域索引的
    UIPropertyGridEditorPart: 提供修改定制属性的UI

    1. <asp:EditorZone ID="EditorZone1" runat="server">
    2.  <ZoneTemplate>
    3.   <asp:AppearanceEditorPart ID="AppearanceEditorPart1" runat="server" />
    4.   <asp:BehaviorEditorPart ID="BehaviorEditorPart1" runat="server" />
    5.   <asp:LayoutEditorPart ID="LayoutEditorPart1" runat="server" />
    6.   <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" runat="server" />
    7.  </ZoneTemplate>
    8. <asp:EditorZone>

     

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

    1. int myVar;
    2. [WebBrowsable]
    3. public int MyProperty
    4. {
    5.  get { return myVar; }
    6.  set { myVar = value; }
    7. }

     

    EditZone控件允许交互式的对Web Parts进行更改,可以包含一个或多个EditPart控件。
  5. Web Part通讯

     

    通讯的提供者需要实现方法返回接口,方法特性[ConnectionProvider]
    通讯的订阅者需要实现方法接收接口,方法特性[ConnectionConsumer]

    工作方式
    1.WebPartManager调用[ConnectionProvider]方法
    2.WebPartManager从返回参数中获得接口
    3.WebPartManager调用[ConnectionConsumer]方法将接口传递给订阅者
    4.订阅者用给定的接口也发布者通讯

    静态通讯方式
    在设计时就把WebPart之间相互通讯的关系在WebPartManager的StaticConnections元素中定义好了,最终用户无法修改。

    1. <asp:WebPartManager ID="WebPartManager1" runat="server">
    2.  <StaticConnections>
    3.   <asp:WebPartConnection ID="myConnection" ConsumerID="MyConsumer" ProviderID="MyProvider" ConsumerConnectionPointID="MyConsumerPoint" ProviderConnectionPointID="MyProviderPoint"/>
    4.  </StaticConnections>
    5. </asp:WebPartManager>

     

    动态通讯方式
    用ConnectionZone控件提供供Web Part进行通讯的UI。最终用户可以在运行时自定义绑定WebPart之间的通讯。

    1. <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />

     

    Web Part可以类似于事件的方式相互通讯,提供者发布接口,订阅者通过接口获得数据。而通讯之间的联系是由WebPartManger来管理的,它从提供者获得接口,向订阅者发布接口。通讯可以是静态的,在设计时就定义好,也可以是动态的,即在运行时由ConnectionsZone提供后期绑定的UI。
  6. Web Parts个性化

    使用Web Part个性化服务可以自动保存相关的Web Part的属性(布局,外观等等),还可以自动保存标记为PersonalizableAttribute的定制属性。

    在PersonalizationAdministration类里还提供了一系列有关个性化服务的API, 来供我们调用。

    还可以为每个用户提供各自的个性化服务,只需要把属性声明为[Personalizable]就可以了。

    也可以将属性声明为[Personalizable (PersonalizationScope.Shared)],这样的话,这个属性就可以被每个用户共享。

    Web Parts个性化服务是基于Provider模式的。Beta1的时候提供了两个Provider:
    AccessPersonalizationProvider(Access)
    AqlPersonalizationProvider(SQL Server)
    在Beta2中AccseePersonalizationProvider已经被移除了。
    也可以使用自定义Provider增加对其它数据源的支持。

    如使用SQL Server的Provider需要在Web.config文件中加入声明:

    1. <webParts>
    2.  
    3. <personalization defaultProvider="AspNetSqlPersonalizationProvider" />
    4. </webParts>

     

  7. 定制Web Parts

    任何控件均可以作为Web Parts来运行,但是最好是采用继承自WebPart的控件。这样可以得到更好的应用,如可以控制控件标题及其它与UI相关的属性,控件的AllowClose, AllowZoneChange, AllowMinimize和其它行为属性,可以应用于基于角色的安全特性,也可以增加一些自定义的操作,包括导出Web Part等等。

    增加自定义操作:

    1. public class MyWebPart : WebPart
    2. {
    3.  public override WebPartVerbCollection Verbs
    4.  {
    5.   get
    6.   {
    7.    EnsureChildControls();
    8.    WebPartVerb verb = new WebPartVerb(new WebPartEventHandler(OnClearResults));
    9.    verb.Text = "Clear Results";
    10.    WebPartVerb[] verbs = new WebPartVerb[] { verb };
    11.    return new WebPartVerbCollection(base.Verbs, verbs);
    12.   }
    13.  }
    14.  
    15.  void OnClearResult(object sender, WebPartEventArgs args){...}
    16. }

     

  8. 导出Web Part

    WebPart.ExprotMode属性

     

    WebPartExportMode.None (默认)
    WebPartExportMode.All 允许导出所有数据
    WebPartExportMode.NonSensitiveData 允许导出非敏感数据

    可以在构造函数中对Web Part的导出属性进行定义

    1. public MyWebPart()
    2. {
    3.  this.ExportMode = WebPartExportMode.All;
    4. }

     

    也可以选择某些属性被导出,在属性声明中定义即可。

posted on 2007-04-03 02:19  hfyb  阅读(1712)  评论(0编辑  收藏  举报

导航