CatalogZoneBase.SelectedCatalogPartID Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft eine Zeichenfolge als Bezeichner für das derzeit in einer Zone ausgewählte CatalogPart-Steuerelement ab oder legt diese fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die als Bezeichner für das derzeit ausgewählte Steuerelement verwendet wird. Der Standardwert ist der Wert der ID-Eigenschaft des Steuerelements.

Attribute
ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SelectedCatalogPartID Eigenschaft deklarativ und programmgesteuert verwendet wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der CatalogZoneBase Klassenübersicht.

Beachten Sie, dass der erste Teil des Codebeispiels zwei <asp:catalogzone> Elemente deklariert, und das erste Element einen Wert für die SelectedCatalogPartID -Eigenschaft deklariert.

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

Im zweiten Teil des Codebeispiels wird der Textwert für die SelectedCatalogPartID Eigenschaft des aktuell ausgewählten Steuerelements angezeigt.

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

Wenn Sie die Seite in einem Browser laden, können Sie in der Dropdownliste Katalog auswählen, um zum Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, klicken Sie auf einen der Links zu einem CatalogPart Steuerelement, um es auszuwählen. Klicken Sie dann auf die Schaltfläche Ausgewählte Katalogteil-ID anzeigen , um den Eigenschaftswert anzuzeigen. Beachten Sie, dass der Wert der -Eigenschaft der Wert ist, der deklarativ für die Zone festgelegt wurde. Wenn Sie die anderen CatalogPart Steuerelemente in der Zone auswählen, wird derselbe Wert zum Wert der SelectedCatalogPartID Eigenschaft für jedes Steuerelement, wenn er ausgewählt wird. Wenn Sie den Wert der SelectedCatalogPartID Eigenschaft nicht festlegen, ist der Standardwert immer der Wert der ID Eigenschaft für das aktuell ausgewählte Steuerelement.

Hinweise

Mit SelectedCatalogPartID der -Eigenschaft können Sie einen Bezeichner Ihrer Wahl für das aktuell ausgewählte CatalogPart Steuerelement festlegen. Dadurch wird der Eigenschaftswert des Steuerelements ID nicht geändert, sodass Sie diese Eigenschaft für Ihre eigenen programmgesteuerten Zwecke verwenden können. Wenn Sie beispielsweise immer eine programmgesteuerte Aktion für das aktuell ausgewählte CatalogPart Steuerelement ausführen möchten, können Sie mit dieser Eigenschaft über einen bekannten Wert, den Sie im Voraus festgelegt haben, auf dieses Steuerelement zugreifen.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen