This documentation is archived and is not being maintained.

WebPartZoneBase.CreateWebPartChrome Method

Enables derived zones to substitute a custom WebPartChrome object to change the appearance of WebPart controls in a zone.

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

protected virtual WebPartChrome CreateWebPartChrome()

Return Value

Type: System.Web.UI.WebControls.WebParts.WebPartChrome
A WebPartChrome that determines how WebPart controls in a zone are rendered.

Web Parts chrome refers to the peripheral user interface (UI) elements that frame each WebPart control in a zone. The chrome for a WebPart control includes its border, its title bar, and the icons, title text, and verbs menu that appear within the title bar. The appearance of the chrome is set at the zone level, and applies to all WebPart controls in a zone.

Important noteImportant

The WebPartChrome object affects the entire rendering of the WebPart controls, not merely their chrome elements.

To use the CreateWebPartChrome method, you must create a custom WebPartChrome object to define the appearance of the chrome for Web Parts controls in a zone. You must also create a custom zone that inherits from the WebPartZoneBase class and overrides the CreateWebPartChrome method to be able to substitute your custom chrome object and apply it to the controls in the zone.

.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.