WebPartZoneBase.CreateWebPartChrome Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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.


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
Available since 2.0
Return to top