CatalogZoneBase.CloseVerb 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 une référence à un objet WebPartVerb qui permet à l'utilisateur final de fermer l'interface utilisateur du catalogue et de rétablir la page en mode de navigation normal.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CloseVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CloseVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CloseVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property CloseVerb As WebPartVerb

Valeur de propriété

WebPartVerb

WebPartVerb qui permet à l'utilisateur final de fermer l'interface utilisateur du catalogue sur la page Web.

Attributs: PersistenceModeAttribute

Exemples

L’exemple de code suivant montre comment accéder à la CloseVerb 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.

La première partie de l’exemple de code montre comment accéder à la CloseVerb propriété de manière déclarative dans une page Web. Cet exemple montre comment personnaliser la Description propriété du verbe.

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

La deuxième partie de l’exemple montre comment accéder à la propriété par programmation, à l’aide CloseVerb d’un bouton bascule pour l’activer ou la désactiver.

protected void Button1_Click(object sender, EventArgs e)
{
  if (CatalogZone1.AddVerb.Enabled)
  {
    CatalogZone1.AddVerb.Enabled = false;
    CatalogZone1.CloseVerb.Enabled = false;
  }
  else
  {
    CatalogZone1.AddVerb.Enabled = true;
    CatalogZone1.CloseVerb.Enabled = true;
  }
}

Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  If CatalogZone1.AddVerb.Enabled Then
    CatalogZone1.AddVerb.Enabled = False
    CatalogZone1.CloseVerb.Enabled = False
  Else
    CatalogZone1.AddVerb.Enabled = True
    CatalogZone1.CloseVerb.Enabled = True
  End If

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, en positionnant le pointeur de votre souris sur le bouton Fermer , vous pouvez voir son texte de description dans une info-bulle. Vous pouvez également cliquer sur le bouton Activer ou désactiver les verbes pour montrer que vous pouvez accéder au verbe de fermeture par programmation.

Remarques

Le verbe de fermeture est référencé par la CloseVerb propriété sur un contrôle dérivé de la CatalogZoneBase classe .

L’utilisateur peut cliquer sur le verbe de fermeture dans le pied de page de zone. Lorsque l’utilisateur clique sur le verbe fermer, tous CatalogPart les contrôles sélectionnés par l’utilisateur sont ignorés, l’interface utilisateur du catalogue se ferme et la page revient en mode de navigation normal.

Le verbe de fermeture est un contrôle au niveau de la zone, ce qui signifie que son action s’applique au niveau de la zone entière. Lorsqu’un utilisateur clique sur le verbe fermer, tous les contrôles qui ont été sélectionnés mais qui n’ont pas été ajoutés à la page sont ignorés, le catalogue est fermé et la page revient en mode de navigation.

S’applique à

Partager via