WebParts系列控件说明（转）

最新推荐文章于 2014-06-14 14:43:38 发布

x4545

最新推荐文章于 2014-06-14 14:43:38 发布

阅读量773

点赞数

文章标签： webparts web 通讯 string calendar server

webparts系列控件总结

WebParts系列控件说明：

这里下载代码WebPartManager 控件：

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

使用后的代码如下：

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

Ø WebPartManager.DisplayMode设置或者获取页面的显示模式

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

Ø WebPartManager.DisplayModeChanging 指示显示模式是否要发生改变

WebPartDisplayModeCancelEventArgs 获得新的显示模式并且允许控制者取消这种改变

WebPartManager.DisplayModeChanged 指示显示模式是否已经发生改变
WebPartDisplayModeEventArgs 得到原来的显示模式

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>
    
  </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>

其它的区域类型

CatalogZone             允许用户在页面上添加Web Part
EditorZone               允许用户更改Web Part的属性及布局
ConnectionsZone     允许用户建立Web Part之间的通讯

CatalogZone 控件

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

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

EditorZone控件

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

ConnectionsZone 控件

提供供Web Part进行通讯的UI，最终用户，而不是开发人员创建通讯关系

<asp:ConnectionsZone ID="ConnectionsZone1" Runat="server" />

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>

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
{ ... }
...
}

WebPartsDemo制作过程及相关技术说明

第一阶段实现控件基本功能

1．首先使用vs.net 2005新建一个web站点命名为WebPartsDemo;

2．建立一个页面作为实现该系列控件的载体。在页面上建立一个三行两列的表格，并合并三行单元格，将此作为webpart第二行之间通讯的订阅者显示部分，

3．向标题下放拖放一个WebPartManager控件，分别为每一个单元格里面拖放一个webpartzone控件。

4．向webpartzone1中拖放一个日历控件设置webpartzone1部分属性值，并且选择合适的样式将其title 设置为：Demo之日历控件，注意日历控件本身没有title属性，但当一个控件加入到webpartzone区域中去后，则该控件被自动包装为GenericWebPart类型控件，这些类型的控件有title属性。

5．运行通过浏览器查看，至此一个最简单的webpart控件应用制作完成。

第二阶段在Webpart系列控件中，使用用户自定义的控件

1．我们为工程项目增加一个"baidu.ascx"的控件(参照详细页面)

在btnsearch按钮的click事件中写入如下代码：

Response.Write(Page.IsValid);

string strSearch = HttpUtility.UrlEncode(txtSearch.Text);

Response.Redirect("http://www.baidu.com/s?wd="+ strSearch);
2. 将写好的baidu.ascx控件，整个拖拉到我们刚才建立好的表格中webpartzone2中。

第三阶段结合WebPartManager.DisplayMode设置获取页面的显示模式

设置页面显示模式

往页面适当位置拖放RadioButtonList控件指定其内容分别为浏览模式、布局模式、个人化内容定制、模块编辑模式；并将其 Autopostback 设置为true

编写以下代码

protected void RadioButtonList1_SelectedIndexChanged(object sender, EventArgs e)

{

switch (RadioButtonList1.SelectedIndex)

{

case 0:

WebPartManager1.DisplayMode = WebPartManager.BrowseDisplayMode;

break;

case 1:

WebPartManager1.DisplayMode = WebPartManager.DesignDisplayMode;

break;

case 2:

WebPartManager1.DisplayMode = WebPartManager.CatalogDisplayMode;

break;

case 3:

WebPartManager1.DisplayMode = WebPartManager.EditDisplayMode;

break;

default:

break;

}

结合显示模式添加webpart系列控件

1．往窗体中拖拉一个catlogzone控件

2、往该catlogzone控件区域中，再拖放三个Webpart系列的控件，分别是DeclarativeCatalogPart, PageCatalogPart, and ImportCatalogPart。DeclarativeCatalogPart控件的作用是，显示目前页面上有哪些可以用的webpart控件；PageCatalogPart的作用是，可以让用户通过勾选的方式，选定将哪些控件添加转移到其他webpart区域中去。ImportCatalogPart则可以通过外部磁盘文件的方式，加载其他做好了的webpart部件。

3.向DeclarativeCatalogPart的摸板中添加baidu.ascx控件

４．修改DeclarativeCatalogPart, PageCatalogPart, and ImportCatalogPart。控件部分属性

５.为了在运行过程中用户能够动态的修改webpart的部分属性我们向页面添加一个editor zone的区域控件，往其中再拖放一个appearanceEdiotrPart控件。

至此demo的浏览模式和设计模式及目录编辑模式，webpart编辑模式制作完成。

第四阶段：webpart之间的通讯

１，首先创建两个用户控件作为webpart，一个作为数据的提供者（provider.ascx），另外一个作为数据的订阅者(Consumer.ascx)

２，定义接口

３，在提供者中实现接口成员

４，在提供者中实现[ConnectionProvider]方法

５，在订阅者中实现[ConnectionConsumer]方法

６，在WebPartManager控件中声明连接

详细代码及制作过程请参阅Demo

第五阶段：自定义webpart

１.以编程方式将Web部件添加到 WebPartZone 控件里面的方法取决于需要添加的Web部件的类型。如果是一个从 WebPart 继承的类，需要以编程方式创建一个该类的实例，然后调用 WebPartManager 类的 AddWebPart 方法。调用 AddWebPart 方法时，你需要传入的参数包括：Web部件的实例、目标 WebPartZone 控件、以及Web部件在 WebPartZone 控件中的索引位置。

首先　建立一个从WebPart继承的类

代码如下：

using System.Web.UI;

using System.Web.UI.WebControls.WebParts;

 public class HelloWorld : WebPart {

    public HelloWorld() {

      this.Title = "Hello World";

      this.TitleIconImageUrl = @"img/WhaleBoy.gif";

    protected override void RenderContents(HtmlTextWriter writer) {

      writer.Write("Can I have your attention please");

x4545

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
WebParts系列控件说明（转）

webparts系列控件总结 WebParts系列控件说明：这里下载代码WebPartManager 控件：Web Parts的总控中心,管理 Web Parts及区域的列表管理页面状态 (比如显示状态)，当页面状态时发生改变时触发事件,协助Web Parts间的通讯,管理个性化等.使用后的代码如下：Ø WebPartManager.DisplayMode设置或者获
复制链接

扫一扫