System.Web.UI.WebControls.WebParts.EditorPart Class

Serves as the base class for controls that reside in System.Web.UI.WebControls.WebParts.EditorZoneBase zones and are used to edit System.Web.UI.WebControls.WebParts.WebPart controls.

See Also: EditorPart Members


[System.ComponentModel.Designer("System.Web.UI.Design.WebControls.WebParts.EditorPartDesigner, System.Design, Version=, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner")]
public abstract class EditorPart : Part


The System.Web.UI.WebControls.WebParts.EditorPart class provides a base set of properties and methods that are used by the derived System.Web.UI.WebControls.WebParts.EditorPart controls provided with the Web Parts control set, and by custom System.Web.UI.WebControls.WebParts.EditorPart controls. An System.Web.UI.WebControls.WebParts.EditorPart control allows a user to edit an associated System.Web.UI.WebControls.WebParts.WebPart control by modifying its layout, appearance, properties, behavior, or other characteristics.

The editing user interface (UI), which consists of System.Web.UI.WebControls.WebParts.EditorZoneBase zones that contain System.Web.UI.WebControls.WebParts.EditorPart controls, is displayed after a Web page enters edit mode.


An System.Web.UI.WebControls.WebParts.EditorPart control can be used only within a zone that derives from the System.Web.UI.WebControls.WebParts.EditorZoneBase class, such as the System.Web.UI.WebControls.WebParts.EditorZone control.

After a page has entered edit mode, a user can select a System.Web.UI.WebControls.WebParts.WebPart control to edit by clicking an edit verb on the verbs menu of the selected control. Only one System.Web.UI.WebControls.WebParts.WebPart control can be edited at a time.

Several derived System.Web.UI.WebControls.WebParts.EditorPart controls are provided with the Web Parts control set, as listed in the following table. These controls provide all the editing capabilities that are necessary for most applications. The typical approach for using these controls in a Web Parts page is to declare them in page persistence format within a <zonetemplate> element, where <zonetemplate> is the child element of an <asp:editorzone> element. For a code example, see the Example section of this topic.


Edits the appearance of the associated control, including properties such as its title text, height, width, and border attributes.


Edits certain behaviors of the associated control, such as whether it can be edited, whether it can be closed, or whether it can be moved to another zone. This control is only visible on a page when a control is being edited in shared personalization scope.


Edits layout attributes for the associated control, such as whether it is in a normal or minimized (collapsed) state, and what zone it is placed in.


Edits properties of the associated control, if those properties were declared in the source code with a WebBrowsable attribute.


To improve accessibility, all the System.Web.UI.WebControls.WebParts.EditorPart controls provided in the Web Parts control set are rendered within a <fieldset> element. The <fieldset> element groups the related set of controls used for editing in a given System.Web.UI.WebControls.WebParts.EditorPart control, and it facilitates tabbed navigation among those controls for both visual user agents (such as ordinary Web browsers) and speech-oriented user agents (such as screen-reading software).


Namespace: System.Web.UI.WebControls.WebParts
Assembly: System.Web (in System.Web.dll)
Assembly Versions:
Since: .NET 2.0