WebPartConnectionsEventArgs 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为 WebPartsConnected 控件的 WebPartsDisconnected 和 WebPartManager 事件提供事件数据。
public ref class WebPartConnectionsEventArgs : EventArgs
public class WebPartConnectionsEventArgs : EventArgs
type WebPartConnectionsEventArgs = class
inherit EventArgs
Public Class WebPartConnectionsEventArgs
Inherits EventArgs
- 继承
注解
使用 Web 部件控件集的功能,可以在两 WebPart 个或其他服务器控件之间创建连接,其中一个控件充当提供程序,另一个控件充当数据的使用者。 若要形成连接,这两个控件必须位于继承自 WebPartZoneBase 类 ((例如 WebPartZone 控件) )的区域,并且必须正确设计它们以通过公共接口共享数据。 有关 Web 部件连接的详细信息,请参阅 WebPartConnection 和 Web 部件连接概述。
类 WebPartConnectionsEventArgs 将事件数据传递给使用 WebPartConnectionsEventHandler 委托处理事件的方法。 有两种此类连接相关方法可引发事件并使用 WebPartConnectionsEventArgs 类提供事件数据。 两者都是 控件的成员 WebPartManager 。 方法 OnWebPartsConnected 在 WebPartsConnected 两个服务器控件成功连接后引发 事件,方法 OnWebPartsDisconnected 在两个服务器控件断开连接后引发 WebPartsDisconnected 事件。
开发人员可以为 和 WebPartsDisconnected 事件创建自定义事件处理程序方法WebPartsConnected,在这些方法中,他们可以使用 WebPartConnectionsEventArgs 类访问连接的详细信息。 例如,开发人员可以在 元素上<asp:webpartmanager>
声明 OnWebPartsConnected
属性,并为其分配将处理事件的自定义方法名称。 在自定义处理程序方法中,开发人员可以使用作为参数传递给 方法的对象来访问连接 WebPartConnectionsEventArgs 的详细信息。
类 WebPartConnectionsEventArgs 具有构造函数的两个重载。 构造 WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) 函数是默认值;它初始化 类的属性值。 构造 WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) 函数调用无参数构造函数,然后它还初始化 Connection 属性。
类 WebPartConnectionsEventArgs 具有多个属性,所有这些属性都引用 Web 部件连接的基本方面。 属性 Connection 引用表示整个连接的关联 WebPartConnection 对象。 属性 Provider 引用充当 WebPart 连接中的提供程序的 或其他服务器控件,而 Consumer 属性引用 WebPart 充当使用者的 或 服务器控件。 属性 ProviderConnectionPoint 引用连接的 ProviderConnectionPoint 对象,而 ConsumerConnectionPoint 属性引用 对象 ConsumerConnectionPoint 。
构造函数
属性
Connection |
获取当前连接的 WebPartConnection 对象。 |
Consumer |
获取在连接中作为使用者的 WebPart 控件。 |
ConsumerConnectionPoint |
获取当前连接的 ConsumerConnectionPoint 对象。 |
Provider |
获取在连接中作为提供者的 WebPart 控件。 |
ProviderConnectionPoint |
获取当前连接的 ProviderConnectionPoint 对象。 |
方法
Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
ToString() |
返回表示当前对象的字符串。 (继承自 Object) |