CatalogZoneBase.SelectedCatalogPartID Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá nebo nastaví řetězec jako identifikátor pro aktuálně vybraný CatalogPart ovládací prvek v zóně.

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

Hodnota vlastnosti

String

Řetězec, který slouží jako identifikátor pro aktuálně vybraný ovládací prvek. Výchozí hodnota je hodnota vlastnosti ovládacího prvku ID .

Atributy

ThemeableAttribute

Příklady

Následující příklad kódu ukazuje, jak použít SelectedCatalogPartID vlastnost deklarativně a programově. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad přehledu CatalogZoneBase třídy.

Všimněte si, že první část příkladu kódu deklaruje dva <asp:catalogzone> prvky a první deklaruje hodnotu pro SelectedCatalogPartID vlastnost .

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

V druhé části příkladu kódu se zobrazí textová hodnota vlastnosti SelectedCatalogPartID aktuálně vybraného ovládacího prvku.

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

Když stránku načtete v prohlížeči, můžete výběrem možnosti Katalog z rozevíracího seznamu přepnout do režimu zobrazení katalogu. Jakmile je katalog viditelný, vyberte ho kliknutím na jeden z odkazů na CatalogPart ovládací prvek. Potom klikněte na tlačítko Zobrazit vybrané ID katalogu Id části a zobrazte hodnotu vlastnosti. Všimněte si, že hodnota vlastnosti je hodnota, která byla nastavena deklarativně pro zónu. Pokud vyberete další CatalogPart ovládací prvky v zóně, stane se stejná hodnota hodnotou SelectedCatalogPartID vlastnosti pro každý ovládací prvek, když je vybrána. Pokud nenastavíte hodnotu SelectedCatalogPartID vlastnosti, výchozí hodnota je vždy hodnota ID vlastnosti pro aktuálně vybraný ovládací prvek.

Poznámky

Vlastnost SelectedCatalogPartID umožňuje nastavit identifikátor podle vašeho výběru pro aktuálně vybraný CatalogPart ovládací prvek. Hodnota vlastnosti ovládacího prvku ID se nezmění, takže ji můžete použít pro vlastní programové účely. Pokud například chcete u aktuálně vybraného CatalogPart ovládacího prvku vždy provádět nějakou programovou akci, tato vlastnost vám umožní přístup k tomuto ovládacímu prvku prostřednictvím známé hodnoty, kterou jste předem nastavili.

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Viz také

• ASP.NET ovládací prvky webových částí