CatalogZoneBase.PartLinkStyle 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 controls that are not currently selected in the zone.

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

public Style PartLinkStyle { get; }

Property Value

Type: System.Web.UI.WebControls.Style

A Style that contains style attributes for the controls that are not 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 PartLinkStyle property contains the style attributes for the CatalogPart controls that are not 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 unselected CatalogPart controls.

The following code example demonstrates how to use the PartLinkStyle 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 PartLinkStyle 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 unselected CatalogPart controls 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, notice the style attributes of the unselected CatalogPart controls listed in the zone (by default, the selected CatalogPart control is the DeclarativeCatalogPart control). You can click the Change Part Link Styles button to change the text color of the unselected controls. 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