This documentation is archived and is not being maintained.

WebPartManager.OnWebPartClosed Method

Raises the WebPartClosed event to signal that a control has been removed from a page.

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

protected virtual void OnWebPartClosed(
	WebPartEventArgs e


Type: System.Web.UI.WebControls.WebParts.WebPartEventArgs

A WebPartEventArgs that contains the event data.

The OnWebPartClosed method raises the WebPartClosed event to indicate that a WebPart control (or other server or user control) has been successfully closed on a page.

To close a WebPart control means to remove it from a page so that it is not rendered, and also to place it in a special holding object called a page catalog. A page catalog, which corresponds to the PageCatalogPart control, maintains references to closed WebPart controls for each page. If a PageCatalogPart control is declared on a page within a CatalogZone zone, users can switch the page into catalog display mode, and add back to the page any controls that were previously closed.

The OnWebPartClosed method provides an opportunity for developers to create a custom handler for the WebPartClosed event. Page developers can add a custom handler for the event by adding an OnWebPartClosed attribute to the <asp:webpartmanager> element in a page, and then assigning a custom method name to the attribute. One useful task a developer might carry out in this method is to display a placeholder in place of the closed control, complete with a ToolTip that would inform users how to add the control back to the page.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0