CatalogZoneBase.SelectedCatalogPartID Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Pobiera lub ustawia ciąg jako identyfikator aktualnie wybranej CatalogPart kontrolki w strefie.

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

Wartość właściwości

String

Ciąg, który służy jako identyfikator aktualnie wybranej kontrolki. Wartość domyślna to wartość właściwości kontrolki ID .

Atrybuty

ThemeableAttribute

Przykłady

W poniższym przykładzie kodu pokazano, jak używać SelectedCatalogPartID właściwości deklaratywnie i programowo. Aby zapoznać się z pełnym kodem wymaganym do uruchomienia przykładu, zobacz sekcję Przykład w przeglądzie CatalogZoneBase klasy.

Zwróć uwagę, że pierwsza część przykładu kodu deklaruje dwa <asp:catalogzone> elementy, a pierwsza deklaruje wartość właściwości 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." />

W drugiej części przykładu kodu jest wyświetlana wartość tekstowa właściwości SelectedCatalogPartID aktualnie wybranej kontrolki.

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

Po załadowaniu strony w przeglądarce możesz wybrać pozycję Wykaz z listy rozwijanej, aby przełączyć się do trybu wyświetlania wykazu. Gdy wykaz jest widoczny, kliknij jeden z linków do kontrolki CatalogPart , aby ją wybrać. Następnie kliknij przycisk Pokaż wybrany identyfikator wykazuPart , aby wyświetlić wartość właściwości. Zwróć uwagę, że wartość właściwości jest wartością, która została ustawiona deklaratywnie dla strefy. Jeśli wybierzesz inne CatalogPart kontrolki w strefie, ta sama wartość stanie się wartością SelectedCatalogPartID właściwości dla każdej kontrolki po jej wybraniu. Jeśli nie ustawisz wartości SelectedCatalogPartID właściwości, wartość domyślna jest zawsze wartością ID właściwości dla aktualnie wybranej kontrolki.

Uwagi

Właściwość SelectedCatalogPartID umożliwia ustawienie wybranego identyfikatora dla aktualnie wybranej CatalogPart kontrolki. Nie powoduje to zmiany wartości właściwości kontrolki ID , więc możesz użyć tej właściwości do własnych celów programistycznych. Jeśli na przykład chcesz zawsze wykonać jakąś akcję programową dla aktualnie wybranej CatalogPart kontrolki, ta właściwość umożliwia dostęp do tej kontrolki za pomocą znanej wartości ustawionej z wyprzedzeniem.

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skórki.

Zobacz też

• kontrolki składników Web Part ASP.NET