CatalogZoneBase.SelectedCatalogPartID Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une chaîne comme identificateur pour le contrôle CatalogPart actuellement sélectionné dans une zone.

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

Valeur de propriété

String

Chaîne qui sert d'identificateur pour le contrôle actuellement sélectionné. La valeur par défaut est la valeur de la propriété ID du contrôle.

Attributs: ThemeableAttribute

Exemples

L’exemple de code suivant montre comment utiliser la SelectedCatalogPartID propriété de manière déclarative et programmatique. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la vue d’ensemble de la CatalogZoneBase classe.

Notez que la première partie de l’exemple de code déclare deux <asp:catalogzone> éléments, et la première déclare une valeur pour la SelectedCatalogPartID propriété.

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

Dans la deuxième partie de l’exemple de code, la valeur de texte de la SelectedCatalogPartID propriété du contrôle actuellement sélectionné s’affiche.

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

Lorsque vous chargez la page dans un navigateur, vous pouvez sélectionner Catalogue dans la liste déroulante pour basculer en mode d’affichage catalogue. Lorsque le catalogue est visible, cliquez sur l’un des liens vers un CatalogPart contrôle pour le sélectionner. Cliquez ensuite sur le bouton Afficher l’ID CatalogPart sélectionné pour afficher la valeur de la propriété. Notez que la valeur de la propriété est la valeur définie de manière déclarative pour la zone. Si vous sélectionnez les autres CatalogPart contrôles dans la zone, la même valeur devient la valeur de la SelectedCatalogPartID propriété pour chaque contrôle lorsqu’il est sélectionné. Si vous ne définissez pas la valeur de la SelectedCatalogPartID propriété, la valeur par défaut est toujours la valeur de la ID propriété pour le contrôle actuellement sélectionné.

Remarques

La SelectedCatalogPartID propriété vous permet de définir un identificateur de votre choix pour le contrôle actuellement sélectionné CatalogPart . Cela ne modifie pas la valeur de la propriété du ID contrôle. Vous pouvez donc utiliser cette propriété à vos propres fins programmatiques. Par exemple, si vous souhaitez toujours effectuer une action par programme sur le contrôle actuellement sélectionné CatalogPart , cette propriété vous permet d’accéder à ce contrôle via une valeur connue que vous avez définie à l’avance.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et skins.

S’applique à

Voir aussi

contrôles de composants WebPart ASP.NET

Partager via