WebPartZoneBase.CloseVerb Propriété

  • Référence

Définition

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

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final de fermer les contrôles WebPart contenus dans une zone.

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 les contrôles WebPart.

Attributs
PersistenceModeAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la CloseVerb propriété sur un WebPartZone contrôle. Pour que l’exemple de code fonctionne, vous avez besoin de tout le code de la section Exemple de la HelpVerb propriété .

La partie suivante de l’exemple de code provient de la classe partielle et contient le code qui bascule si le verbe d’aide est activé ou désactivé.

protected void CheckBoxList1_SelectedItemIndexChanged(Object sender, EventArgs e)
{
  foreach (ListItem item in CheckBoxList1.Items)
  {
    WebPartVerb theVerb;
    switch (item.Value)
    {
      case "close":
        theVerb = WebPartZone1.CloseVerb;
        break;
      case "export":
        theVerb = WebPartZone1.ExportVerb;
        break;
      case "delete":
        theVerb = WebPartZone1.DeleteVerb;
        break;
      case "minimize":
        theVerb = WebPartZone1.MinimizeVerb;
        break;
      case "restore":
        theVerb = WebPartZone1.RestoreVerb;
        break;
      default:
        theVerb = null;
        break;
    }

    if (item.Selected)
      theVerb.Enabled = true;
    else
      theVerb.Enabled = false;
  }
}

Protected Sub CheckBoxList1_SelectedItemIndexChanged(ByVal sender As [Object], ByVal e As EventArgs)
  Dim item As ListItem
  For Each item In CheckBoxList1.Items
    Dim theVerb As WebPartVerb
    Select Case item.Value
      Case "close"
        theVerb = WebPartZone1.CloseVerb
      Case "export"
        theVerb = WebPartZone1.ExportVerb
      Case "delete"
        theVerb = WebPartZone1.DeleteVerb
      Case "minimize"
        theVerb = WebPartZone1.MinimizeVerb
      Case "restore"
        theVerb = WebPartZone1.RestoreVerb
      Case Else
        theVerb = Nothing
    End Select

    If item.Selected Then
      theVerb.Enabled = True
    Else
      theVerb.Enabled = False
    End If
  Next item

End Sub

L’autre partie de l’exemple de code est la page Web qui héberge le contrôle personnalisé et contient l’interface utilisateur. Notez que l’élément déclaratif <CloseVerb> dans la zone définit le texte spécifique qui représente le verbe proche dans le menu verbes du WebPart contrôle.

<asp:WebPartZone ID="WebPartZone1" Runat="server">
  <CloseVerb Text="Close WebPart" />
  <HelpVerb Text="View Help" />
  <ExportVerb Text="Export WebPart Definition" />
  <DeleteVerb Text ="Delete WebPart" />
  <MinimizeVerb Description="Minimize the control" />
  <RestoreVerb Description="Restore the control" />
  <ZoneTemplate>
  </ZoneTemplate>  
</asp:WebPartZone>

<asp:WebPartZone ID="WebPartZone1" Runat="server">
  <CloseVerb Text="Close WebPart" />
  <HelpVerb Text="View Help" />
  <ExportVerb Text="Export WebPart Definition" />
  <DeleteVerb Text ="Delete WebPart" />
  <MinimizeVerb Description="Minimize the control" />
  <RestoreVerb Description="Restore the control" />
  <ZoneTemplate>
  </ZoneTemplate>  
</asp:WebPartZone>

Notez également que, étant donné que le contrôle personnalisé WebPart sous-jacent nommé TextDisplayWebPart- utilisé dans l’exemple de code définit la AllowClose propriété false sur dans son constructeur, l’élément <aspSample:TextDisplayPart> dans le catalogue doit définir la AllowClose propriété sur true, afin que le contrôle puisse être fermé dans l’exemple de code suivant.

<asp:CatalogZone ID="CatalogZone1" Runat="server">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      Runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          width="350px" 
          AllowClose="true"
          ExportMode="All"
          HelpMode="Modal"
          HelpUrl="TextWebPartHelp.htm" />            
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
  </ZoneTemplate>
</asp:CatalogZone>

<asp:CatalogZone ID="CatalogZone1" Runat="server">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      Runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          width="350px" 
          AllowClose="true"
          ExportMode="All"
          HelpMode="Modal"
          HelpUrl="TextWebPartHelp.htm" />            
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
  </ZoneTemplate>
</asp:CatalogZone>

Après avoir chargé la page dans un navigateur, basculez la page en mode d’affichage catalogue et ajoutez le TextDisplayWebPart contrôle à la page. Vous pouvez utiliser les zones case activée pour activer et désactiver le verbe de fermeture, et vous pouvez cliquer sur le verbe Fermer webPart dans le menu verbes pour fermer le contrôle. Après avoir fermé le contrôle, si vous retournez la page en mode d’affichage du catalogue, vous pouvez cliquer sur le catalogue de pages, sélectionner le instance d’origine du TextDisplayWebPart contrôle que vous avez fermé et le rouvrir sur la page.

Remarques

Le verbe de fermeture référencé par la CloseVerb propriété s’affiche dans le menu verbes de chaque WebPart contrôle d’une zone.

La fermeture d’un contrôle le supprime de l’interaction sur une page, bien que si les développeurs fournissent l’interface utilisateur appropriée, telle qu’une CatalogZone zone contenant un PageCatalogPart contrôle, un utilisateur peut basculer la page dans CatalogDisplayMode et ajouter une instance précédemment fermée d’un contrôle à la page.

S’applique à

Voir aussi