This documentation is archived and is not being maintained.

WebPartConnectionsCancelEventHandler Delegate

Represents the method that will handle the WebPartsConnecting event or WebPartsDisconnecting event of a WebPartManager control.

Namespace:  System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

Public Delegate Sub WebPartConnectionsCancelEventHandler ( _
	sender As Object, _
	e As WebPartConnectionsCancelEventArgs _


Type: System.Object
The source of the event.
Type: System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventArgs
A WebPartConnectionsCancelEventArgs that contains the event data.

The WebPartsConnecting event is raised by the OnWebPartsConnecting method, and it signals that the connection process has begun (for example, a user has selected a control and clicked a connect verb), but is not yet completed. The event provides an opportunity to cancel a connection before it is complete. If the connection is successfully completed, this event is followed by the WebPartsConnected event.

The WebPartsDisconnecting event is raised by the OnWebPartsDisconnecting method, and it signals the fact that a user has clicked a disconnect verb, or the DisconnectWebParts method has otherwise been called. The event provides an opportunity to cancel the process of ending a connection before it is complete. If the connection is ended successfully, this event is followed by the WebPartsDisconnected event.

The method specified in the WebPartConnectionsCancelEventHandler delegate is called when a WebPartsConnecting or WebPartsDisconnecting event is raised.

Page developers can add custom handlers for the events by adding the OnWebPartsDisconnecting and OnWebPartsConnecting attributes to the <asp:webpartmanager> element, and assigning custom method names to the attributes. A custom handler can also be assigned programmatically. For more information on programmatically assigning an event handler, see How to: Connect Event Handler Methods to Events.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.