CatalogZoneBase.SelectedCatalogPartID Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta una stringa come identificatore per il controllo CatalogPart attualmente selezionato in una zona.

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

Valore della proprietà

String

Stringa che funge da identificatore per il controllo attualmente selezionato. Il valore predefinito è quello della proprietà ID del controllo.

Attributi: ThemeableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come usare la SelectedCatalogPartID proprietà dichiarativamente e a livello di codice. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio della panoramica della CatalogZoneBase classe.

Si noti che la prima parte dell'esempio di codice dichiara due <asp:catalogzone> elementi e la prima dichiara un valore per la SelectedCatalogPartID proprietà.

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

Nella seconda parte dell'esempio di codice viene visualizzato il valore di testo per la SelectedCatalogPartID proprietà del controllo attualmente selezionato.

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

Quando si carica la pagina in un browser, è possibile selezionare Catalogo dall'elenco a discesa per passare alla modalità di visualizzazione del catalogo. Quando il catalogo è visibile, fare clic su uno dei collegamenti a un CatalogPart controllo per selezionarlo. Fare quindi clic sul pulsante Mostra ID CatalogPart selezionato per visualizzare il valore della proprietà. Si noti che il valore della proprietà è il valore impostato in modo dichiarativo per la zona. Se si selezionano gli altri CatalogPart controlli nella zona, lo stesso valore diventa il valore della SelectedCatalogPartID proprietà per ogni controllo quando viene selezionato. Se non si imposta il valore della SelectedCatalogPartID proprietà, il valore predefinito è sempre il valore della ID proprietà per il controllo attualmente selezionato.

Commenti

La SelectedCatalogPartID proprietà consente di impostare un identificatore scelto per il controllo attualmente selezionato CatalogPart . Ciò non modifica il valore della proprietà del ID controllo, quindi è possibile usare questa proprietà per scopi a livello di codice. Ad esempio, se si vuole eseguire sempre un'azione a livello di codice sul controllo attualmente selezionato CatalogPart , questa proprietà consente di accedere a tale controllo tramite un valore noto impostato in anticipo.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e skin.

Si applica a

Vedi anche

ASP.NET controlli web part