Udostępnij przez

CatalogZoneBase.SelectedCatalogPartID Właściwość

  • Odwołanie

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 deklaratywnie i programowo używać SelectedCatalogPartID właściwości. Aby zapoznać się z pełnym kodem wymaganym do uruchomienia przykładu, zobacz sekcję Przykładowe CatalogZoneBase omówienie 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 go wybrać. Następnie kliknij przycisk Pokaż wybrany identyfikator wykazu, 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 , dlatego można użyć tej właściwości do własnych celów programowych. Jeśli na przykład chcesz zawsze wykonać jakąś akcję programową w aktualnie wybranej CatalogPart kontrolce, ta właściwość umożliwia dostęp do tej kontrolki za pomocą znanej wartości ustawionej wcześniej.

Nie można ustawić tej właściwości według motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skóry.

Dotyczy

Zobacz też