CatalogZoneBase.SelectedPartLinkStyle Property


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

Gets an object that contains style attributes for the CatalogPart control that is currently selected in the zone.

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

public Style SelectedPartLinkStyle { get; }

Property Value

Type: System.Web.UI.WebControls.Style

A Style that contains style attributes for the control that is currently selected.

In a CatalogZoneBase zone, links are displayed for each type of CatalogPart control: PageCatalogPart, DeclarativeCatalogPart, and ImportCatalogPart. When a user clicks one of the links, the corresponding CatalogPart control becomes the selected control, and the child controls contained by that selected control become visible.

The Style object referenced by the SelectedPartLinkStyle property contains the style attributes of the link for the CatalogPart control that is currently selected. Although the object referenced by the property is read-only, you can still use it to set the underlying style characteristics for the selected CatalogPart control.

The following code example demonstrates how to use the SelectedPartLinkStyle property declaratively and programmatically. For the full code required to run the example, see the Example section of the CatalogZoneBase class overview.

Notice that the first part of the code example declares two <asp:catalogzone> elements, and the first one declares a value for the SelectedPartLinkStyle property.

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
          title = "Text Content WebPart" 
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

In the second part of the code example, the text color for the selected CatalogPart control is set to a different value.

protected void Button5_Click(object sender, EventArgs e)
  CatalogZone1.PartLinkStyle.ForeColor = System.Drawing.Color.Red;
  CatalogZone1.SelectedPartLinkStyle.ForeColor = 

When you load the page in a browser, you can select Catalog from the drop-down list to switch to catalog display mode. When the catalog is visible, click the link for one of the listed CatalogPart controls, and notice the style attributes of the selected control. You can click the Change Part Link Styles button to change the text color of the selected control. You can also click the links for the unselected controls, to see how the style attributes change when a control is selected.

.NET Framework
Available since 2.0
Return to top