SharePoint 自定义WebPart之间的连接

  1、创建SharePoint解决方案,添加两个WebPart分别用来发送和接收;

SharePoint 自定义WebPart之间的连接_第1张图片

  2、发送值的WebPart需要继承自IWebPartField(当然,根据需要还可以选择IWebPartField,IWebPartParameters,IWebPartRow,IWebPartTable,具体参见msdn),原理是将需要发送的值,放到一个接口实例里;

  public class SendWebPart : WebPart, IWebPartField

  详细代码:

 1 private TextBox tb;
 2 private Button btn;
 3 
 4 protected override void CreateChildControls()
 5 {
 6     tb = new TextBox();
 7     Controls.Add(tb);
 8     btn = new Button();
 9     btn.Text = "Send";
10     Controls.Add(btn);
11 }
12 //创建一个接口实例
13 [ConnectionProvider("Send", AllowsMultipleConnections = true)]
14 public IWebPartField SendObject()
15 {
16     EnsureChildControls();
17     return this;
18 }
19 
20 //将数据callback到接口实例
21 public void GetFieldValue(FieldCallback callback)
22 {
23     EnsureChildControls();
24     callback(tb.Text);
25 }
26 // Schema 属性返回 PropertyDescriptor 对象所封装的数据字段的架构信息
27 public System.ComponentModel.PropertyDescriptor Schema
28 {
29     get { return null; }
30 }

  3、接受数据的WebPart,原理就是在render之前去共享的接口实例中获取值,然后使用;

 1 private Label lbl;
 2 private IWebPartField provider;
 3 
 4 protected override void CreateChildControls()
 5 {
 6     lbl = new Label();
 7     Controls.Add(lbl);
 8 }
 9 //检索接口实例
10 [ConnectionConsumer("GetObject")]
11 public void RecvObject(IWebPartField prov)
12 {
13     provider = prov;
14 }
15 //获取接口实例中的数据
16 private void GetData(object fieldValue)
17 {
18     lbl.Text = Convert.ToString(fieldValue);
19 }
20 //在Render前去接口实例获取值
21 protected override void OnPreRender(EventArgs e)
22 {
23     if (provider != null)
24         provider.GetFieldValue(new FieldCallback(GetData));
25     base.OnPreRender(e);
26 }

  4、部署WebPart,然后连接,如下图:

SharePoint 自定义WebPart之间的连接_第2张图片

  5、查看效果

  点击Send前,只能看到页面上的两个webpart,如下图:

SharePoint 自定义WebPart之间的连接_第3张图片

  在TextBox中输入值,点击Send,刷新页面,TextBox中的值已经从SendWebPart中发送到ReceiveWebPart中了,两个自定义WebPart连接成功!

SharePoint 自定义WebPart之间的连接_第4张图片

总 结

  在完成了两个自定义WebPart连接以后,自己还想过连接SharePoint自带的WebPart,但是由于时间关系,还没有发现如何连接,有成功的希望可以给我留言~~~谢谢~~

备 注

  此接口旨在用于 Web 部件连接。在 Web 部件连接中,位于 WebPartZoneBase 区域中的两个服务器控件建立一个连接并共享数据,其中一个控件充当使用者,另一个控件充当提供者。Web 部件连接中共享数据的机制是接口实例,提供者通过使用回调方法将其提供给使用者。若要建立连接,使用者和提供者必须同时使用同一接口类型共享数据。如果使用者无法识别由提供者发送的接口类型,还可以通过使用转换器(WebPartTransformer 对象)连接控件,转换器可将提供者发送的接口实例转换为使用者可以识别的类型。有关连接的详细信息,请参见 WebPartConnection 和 Web 部件连接概述。

  IWebPartField 接口是 Web 部件控件集中所包含的一个提供者接口,用作基于数据字段创建连接的标准接口。您也可以创建自定义接口以用于 Web 部件连接,但在由数据驱动的许多 Web 应用程序中,使用 IWebPartField 接口基于数据源中的公共行(有关详细信息,请参见 IWebPartRow 接口)、表(有关详细信息,请参见 IWebPartTable 接口)或字段创建连接是很有用的。在典型连接中,充当提供者的 WebPart 控件将实现 IWebPartField 接口并用特殊的回调方法将该接口的实例提供给使用者。例如,提供者可以为用户信息表中包含 Web 用户邮政编码数据的字段实现 IWebPartField 接口。另一个充当使用者的 WebPart 控件则定义一个特殊的方法来接收该接口实例,然后可以提取邮政编码数据,根据该邮政编码查询并显示天气信息。

  IWebPartField 接口有两个公开的成员。Schema 属性返回 PropertyDescriptor 对象所封装的数据字段的架构信息。GetFieldValue 方法声明一个方法,在调用回调方法时,实施者(如提供者控件)使用该方法检索接口实例的字段数据。

参考链接

  http://msdn.microsoft.com/zh-cn/library/system.web.ui.webcontrols.webparts.iwebpartfield(v=VS.80).aspx

你可能感兴趣的:(SharePoint 自定义WebPart之间的连接)