CatalogZoneBase.SelectedCatalogPartID Eigenschap

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

Waarde van eigenschap

Een tekenreeks die fungeert als de id voor het geselecteerde besturingselement. De standaardwaarde is de waarde van de eigenschap van het besturingselement ID .

Kenmerken

ThemeableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de SelectedCatalogPartID eigenschap declaratief en programmatisch gebruikt. Zie de sectie Voorbeeld van het CatalogZoneBase klassenoverzicht voor de volledige code die nodig is om het voorbeeld uit te voeren.

U ziet dat het eerste deel van het codevoorbeeld twee <asp:catalogzone> elementen declareert en dat de eerste een waarde voor de SelectedCatalogPartID eigenschap declareert.

<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." />

In het tweede deel van het codevoorbeeld wordt de tekstwaarde voor de SelectedCatalogPartID eigenschap van het geselecteerde besturingselement weergegeven.

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

Wanneer u de pagina in een browser laadt, kunt u Catalogus selecteren in de vervolgkeuzelijst om over te schakelen naar de weergavemodus van de catalogus. Wanneer de catalogus zichtbaar is, klikt u op een van de koppelingen naar een CatalogPart besturingselement om deze te selecteren. Klik vervolgens op de knop Geselecteerde catalogusonderdeel-id weergeven om de eigenschapswaarde weer te geven. U ziet dat de waarde van de eigenschap de waarde is die declaratief is ingesteld voor de zone. Als u de andere CatalogPart besturingselementen in de zone selecteert, wordt dezelfde waarde de waarde van de SelectedCatalogPartID eigenschap voor elk besturingselement wanneer dit wordt geselecteerd. Als u de waarde van de SelectedCatalogPartID eigenschap niet instelt, is de standaardwaarde altijd de waarde van de ID eigenschap voor het geselecteerde besturingselement.

Opmerkingen

Met SelectedCatalogPartID de eigenschap kunt u een id van uw keuze instellen voor het geselecteerde besturingselement CatalogPart . Hiermee wordt de eigenschapswaarde van ID het besturingselement niet gewijzigd, dus u kunt deze eigenschap gebruiken voor uw eigen programmatische doeleinden. Als u bijvoorbeeld altijd een programmatische actie wilt uitvoeren op het geselecteerde CatalogPart besturingselement, kunt u met deze eigenschap toegang krijgen tot dat besturingselement via een bekende waarde die u vooraf hebt ingesteld.

Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.

Zie ook

• ASP.NET besturingselementen voor webonderdelen