CatalogZoneBase.SelectedCatalogPartID Egenskap

public:
 property System::String ^ SelectedCatalogPartID { System::String ^ get(); void set(System::String ^ value); };

[System.Web.UI.Themeable(false)]
public string SelectedCatalogPartID { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.SelectedCatalogPartID : string with get, set

Public Property SelectedCatalogPartID As String

Egenskapsvärde

En sträng som fungerar som identifierare för den markerade kontrollen. Standardvärdet är värdet för kontrollens ID egenskap.

Attribut

ThemeableAttribute

Exempel

Följande kodexempel visar hur du använder SelectedCatalogPartID egenskapen deklarativt och programmatiskt. Den fullständiga kod som krävs för att köra exemplet finns i avsnittet Exempel i klassöversikten CatalogZoneBase .

Observera att den första delen av kodexemplet deklarerar två <asp:catalogzone> element och den första deklarerar ett värde för SelectedCatalogPartID egenskapen.

<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."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<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."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

I den andra delen av kodexemplet visas textvärdet för egenskapen för SelectedCatalogPartID den markerade kontrollen.

protected void Button4_Click(object sender, EventArgs e)
{
  Label1.Text = CatalogZone1.SelectedCatalogPartID;
}

Protected Sub Button4_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  Label1.Text = CatalogZone1.SelectedCatalogPartID
End Sub

När du läser in sidan i en webbläsare kan du välja Katalog i listrutan för att växla till katalogvisningsläge. När katalogen är synlig klickar du på en av länkarna till en CatalogPart kontroll för att välja den. Klicka sedan på knappen Visa vald katalogDel-ID för att visa egenskapsvärdet. Observera att värdet för egenskapen är det värde som har angetts deklarativt för zonen. Om du väljer de andra CatalogPart kontrollerna i zonen blir samma värde värdet SelectedCatalogPartID för egenskapen för varje kontroll när den väljs. Om du inte anger värdet för SelectedCatalogPartID egenskapen är standardvärdet alltid värdet ID för egenskapen för den valda kontrollen.

Kommentarer

Med SelectedCatalogPartID egenskapen kan du ange valfri identifierare för den valda CatalogPart kontrollen. Detta ändrar inte kontrollens egenskapsvärde ID , så du kan använda den här egenskapen för dina egna programmatiska syften. Om du till exempel alltid vill utföra någon programmatisk åtgärd på den valda CatalogPart kontrollen kan du med den här egenskapen komma åt kontrollen via ett känt värde som du angav i förväg.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Se även

• ASP.NET webbdelskontroller