This documentation is archived and is not being maintained.

LayoutEditorPart Class

Note: This class is new in the .NET Framework version 2.0.

Provides an editor control that enables end users to edit several layout-oriented user interface (UI) properties on an associated WebPart control. This class cannot be inherited.

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

public ref class LayoutEditorPart sealed : public EditorPart
public final class LayoutEditorPart extends EditorPart
public final class LayoutEditorPart extends EditorPart

The LayoutEditorPart class is an editor control that derives from the EditorPart class, and is used to edit properties that affect the layout of an associated WebPart or GenericWebPart control.

Just as there are tool-oriented zones in the Web Parts control set (for details, see the ToolZone class overview), there are tool-oriented part controls (tool parts), and each tool part must reside in a certain type of tool zone. Tool parts in the Web Parts control set have two distinguishing characteristics:

  • They are helper controls that enable end users to personalize controls on a Web Parts page.

  • They are visible only in certain display modes.

The LayoutEditorPart control is a tool part that becomes visible only when a Web Parts page is in edit mode, and when a specific WebPart control has been selected for editing. The LayoutEditorPart control, like all other EditorPart controls, resides in an EditorZone control.


An EditorZone zone can contain only EditorPart controls, and EditorPart controls cannot be placed in any other type of zone.

The LayoutEditorPart class has a Title property, which gets or sets the title for a layout control. The class also has a Display property, which overrides the base property and returns true. This means that the LayoutEditorPart control is always visible when the page is in edit mode, even if the AllowEdit property on the WebPart control being edited is set to false. In other words, users can always edit the properties in a LayoutEditorPart control, even if a specified WebPart control cannot be edited by the other EditorPart controls.

The LayoutEditorPart class also has two important methods, ApplyChanges and SyncChanges, which it inherits from the EditorPart class and overrides. The methods are critical because they enable getting and setting the property values between the field values of the editor control and the properties on the WebPart control being edited.

In most cases, the LayoutEditorPart control should be used in page persistence format by declaring an <asp:layouteditorpart> element inside a <zonetemplate> element, which is in turn contained by an <asp:editorzone> element on a Web page. The LayoutEditorPart control enables end users to edit the following UI properties of a WebPart control:

To edit other properties and behavior of WebPart controls, you can use the other EditorPart controls supplied with the Web Parts control set. These controls include the BehaviorEditorPart, the AppearanceEditorPart, and the PropertyGridEditorPart control. The supplied EditorPart controls should provide most editing features required to edit WebPart controls, but you can also create a custom editor control by inheriting from the EditorPart class. For a code example, see the EditorPart class overview.


To improve accessibility, the LayoutEditorPart control is rendered within a <fieldset> element. The <fieldset> element groups the related set of controls used for editing in the LayoutEditorPart 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).


The markup rendered by default for this control might not conform to accessibility standards such as the Web Content Accessibility Guidelines 1.0 (WCAG) priority 1 guidelines. For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

How to: Set the Display Mode of a Web Parts PageBuilding ASP .NET Web Applications
How to: Set the Display Mode of a Web Parts PageBuilding ASP .NET Web Applications

The following code example demonstrates how to declare a LayoutEditorPart control on a Web page, and enable it to edit several UI properties of a WebPart control. The code example has three parts:

  • A user control that enables you to change display modes on a Web Parts page.

  • A Web page that contains an EditorZone control and a LayoutEditorPart control, which is used to edit the layout properties of a BulletedList control.

  • An explanation of how the example works when you load the page in a browser.

The first part of this code example is the user control that enables users to change display modes on a Web page. For details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

No code example is currently available or this language may not be supported.

The second part of the code example is the Web page. It contains a declarative reference to an EditorZone control, with a child <zonetemplate> element that contains declarative references to a LayoutEditorPart control. Note that the page also contains a BulletedList control that is bound to the Pubs database; because this control resides in a WebPartZone zone, it functions as a WebPart control that can be edited by the LayoutEditorPart control.

No code example is currently available or this language may not be supported.

When you load the page in a browser, you can select Edit Mode in the Display Mode drop-down list control to switch to edit mode. You can click the verbs menu (the downward arrow) in the title bar of the Author List WebPart control, and click Edit to begin editing. When the editing UI is visible, you can see the LayoutEditorPart control, and a button and text box positioned above it. If you make some changes in the editing UI and click the Apply button, you can use the Display Mode drop-down list control to return the page to browse mode and see the full effect of the editing changes.

  • AspNetHostingPermission  for operating in a hosted environment. Demand value: LinkDemand; Permission value: Minimal.


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

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

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

.NET Framework

Supported in: 2.0