WebPartManager Web Server Control Overview

The WebPartManager control is the central control of the Web Parts control set. It manages all the Web Parts controls, Web Parts functionality, and Web Parts events.

You must add one (but only one) WebPartManager control to every page that uses Web Parts controls. The WebPartManager control works only with authenticated users.

This topic contains:

The following table lists tasks that are performed by the WebPartManager control.

Task

Control Functionality

Managing Web Parts controls

Manages the controls on a page that provide Web Parts features. This includes WebPart controls, connections, and zones.

Adding and removing Web Parts controls

Provides the methods for adding, deleting, and closing WebPart controls on a page.

Administering connections

Adds and removes connections between controls. Monitors the connections for problems.

Personalizing controls and pages

Enables users to move controls on a page, and displays the modes in which users can edit the appearance, properties, and behavior of controls. Maintains user-specific personalization settings on each page.

Toggling between page views

Switches between page views, and enables users to carry out tasks such as changing page layout or editing controls.

Raising Web Parts life-cycle events

Defines and raises life-cycle events for Web Parts controls, includes events for when controls are added, moved, connected, or deleted.

Enabling import and export of controls

Exports XML streams that contain the state of the properties of WebPart controls, and lets users import the files to personalize controls in other pages or sites.

Associating Web Parts Controls with a WebPartManager Control

To associate a Web Parts control with a WebPartManager control, you put the Web Parts control in a WebPartZone control zone. You must also put a single WebPartManager control on the same page.

For a code example that shows how to use the WebPartManager control, see System.Web.UI.WebControls.WebParts.WebPartManager.

NoteNote:

On master pages whose content pages have static Web Parts connections, use a ProxyWebPartManager control in place of a WebPartManager control.

Back to top

WebPartManager

Provides the class definition of the WebPartManager Web server control.

Back to top

Community Additions

ADD
Show: