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 aktuálně vybraného ovládacího prvku. 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žívat 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í část deklaruje hodnotu vlastnosti SelectedCatalogPartID .

<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 z rozevíracího seznamu vybrat katalog a přepnout do režimu zobrazení katalogu. Když je katalog viditelný, klikněte na některý z odkazů na ovládací prvek a vyberte ho CatalogPart . Potom kliknutím na tlačítko Zobrazit id vybrané části katalogu zobrazte hodnotu vlastnosti. Všimněte si, že hodnota vlastnosti je hodnota, která byla nastavena deklarativní pro zónu. Pokud vyberete ostatní CatalogPart ovládací prvky v zóně, stejná hodnota se stane hodnotou SelectedCatalogPartID vlastnosti pro každý ovládací prvek při jeho výběru. Pokud nenastavíte hodnotu SelectedCatalogPartID vlastnosti, výchozí hodnota je vždy hodnota ID vlastnosti pro aktuálně vybraný ovládací prvek.

Poznámky

Tato SelectedCatalogPartID vlastnost umožňuje nastavit identifikátor podle vašeho výběru pro aktuálně vybraný CatalogPart ovládací prvek. Tato možnost nemění hodnotu vlastnosti ovládacího prvku ID , takže tuto vlastnost 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ést určitou programovou akci, tato vlastnost umožňuje přístup k tomuto ovládacímu prvku prostřednictvím známé hodnoty, kterou jste nastavili předem.

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

Viz také

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