System.Web 2.0.0.0 System.Web.UI.WebControls.Panel System.Web.UI.INamingContainer System.Web.UI.WebControls.ICompositeControlDesignerAccessor

The class defines properties that are common to all part controls and enable them to have a modular and consistent appearance on a Web page. These common properties include a title, a description, and characteristics of the chrome or frame that surrounds a part control.

The property specifies a title for the part control. The property is used to summarize the part control's purpose, and appears as a ToolTip in the title bar of the control. The property dictates what kind of border is rendered around a part control, while the property indicates whether a part control is rendered normally, or minimized. The border of a part control is affected by the properties of the zone that contains it; for example, the property affects the frames of all part controls contained in a zone.

One type of part control is the control, which renders content inside a corresponding zone. Another type is the control, which provides user interface (UI) controls used to modify (personalize) individual controls. A third type of part control is the control, which provides a list of controls that users can add to or remove from a Web page.

Part controls are contained in zones, all of which derive from the abstract class. A zone is responsible for organizing the part controls it contains. Each zone also renders UI elements for itself, including a header, a footer, a title bar, and UI elements around each contained part control, such as borders.

While part controls usually reside in zones, it is possible to place a part control outside a zone, if the control is referenced declaratively in the markup of a Web page. If a part control is declared outside a zone on a Web page, the control still works, but loses most of its Web Parts functionality. For example, the control cannot be edited, and cannot be dragged into a zone at run time. It is also helpful to remember that no part control can be dragged from a zone and dropped onto a page outside of a zone at run time.

Some examples of base part types, and their corresponding zone types, are shown in the following table.

Part control type

Zone type

The various kinds of part controls that derive from the class handle the inherited, UI-oriented properties differently. controls override several of the inherited UI properties, and mark them with the Personalizable attribute (for details, see the class documentation), which enables the values of those properties to be saved for future browser sessions, a feature known as personalization. For example, if you programmatically enable a user to update the value of a control's property at run time, that value will be personalized (assuming that personalization is enabled, which is the default). Several UI properties that controls inherit from the class, and from the class, are handled the same way.

In contrast, other part controls, such as and , do not enable the inherited UI properties to be personalized. For this reason, programmatically assigned property values are not saved for future browser sessions. For example, if you programmatically enable a user to update a control's property at run time, the updated value is lost after the control is closed or the browser session ends.

An easy way to save the values on such inherited UI properties for and controls for future browser sessions is to declare the property values in page persistence format. However, this is a static approach and still does not allow users to personalize the property values. As an alternative, if you want to enable programmatic updates to the inherited UI properties so users can personalize them at run time, you can use private, static variables to save the property values. Each time a new instance of an or control is created (for example, in the method that handles the control's event), you can reassign a static variable's value to a corresponding property. Such an approach gives users the ability to personalize the editing UI and catalog UI of a Web Parts application.

Serves as the base class for all Web Parts part controls, which render a modular user interface on a Web Forms page.

- Property
  System.Web.UI.WebControls.WebParts.PartChromeState To be added.

  A part control's can be normal or minimized.

  Gets or sets whether a part control is in a minimized or normal state.

  2.0.0.0
- Property
  System.Web.UI.WebControls.WebParts.PartChromeType To be added.

  A part control's property determines what kind of border surrounds the control. Options include showing a title only, a border only, a title and border, neither, or the default option, which simply uses the value of the property.

  Gets or sets the type of border that frames a Web Parts control.

  2.0.0.0
- Property
  System.Web.UI.ControlCollection To be added.

  On an ASP.NET page, when controls are added declaratively between the opening and closing tags of a server control, ASP.NET automatically adds the controls to the containing server control's object. Any HTML tags or text strings that are not processed on the server are treated as objects. These are added to the collection like other server controls.

  The property allows you programmatic access to the instance of the class for any server control. You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

  Gets a object that contains the child controls for a specified server control in the user interface hierarchy.

  2.0.0.0
- Method
  System.Void To be added. To be added. 2.0.0.0
- Property
  System.String To be added.

  The property is typically a string that is used in catalogs that provide lists of part controls, and as a ToolTip in the part control's title bar. The content of the appears in a ToolTip when you position your mouse pointer over the title text in a part control's title bar. The ToolTip text is created from the value of the property, followed by a hyphen, followed by the property value.

  The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.

  Gets or sets a brief phrase that summarizes what the part control does, for use in ToolTips and catalogs of part controls.

  2.0.0.0
- Method
  2.0.0.0
  System.Void To be added.

  Allows the developer of a designer for a composite part control to recreate the control's child controls on the design surface.

- Property
  System.String To be added.

  The visible title text in a part control's title bar is set by the property. The title text also appears as part of the ToolTip text when you position your mouse pointer over the title bar of a control or other server control that appears in a zone.

  The style of the title text is determined by the property of the zone that contains the part control.

  If you do not supply a title for a control, the Web Parts control set automatically calculates a default string to use as a title. For more information, see . Also, it is possible to provide a standard subtitle that is appended to the title string. For details, see .

  The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.

  Gets or sets the title of a part control.

  2.0.0.0