WebPartZoneBase.DeleteVerb 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 supprimer les contrôles WebPart contenus dans une zone.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ DeleteVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb DeleteVerb { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DeleteVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property DeleteVerb As WebPartVerb

Valeur de propriété

WebPartVerb

WebPartVerb qui permet à l'utilisateur final de supprimer les contrôles WebPart.

Attributs
PersistenceModeAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la DeleteVerb 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 de suppression 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 <DeleteVerb> dans la zone définit le texte spécifique qui représente le verbe supprimer dans le menu déroulant des verbes pour le 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>

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 supprimer sur le TextDisplayWebPart contrôle, mais le verbe apparaît dans le menu uniquement lorsque la page est en mode d’affichage catalogue ou création. Si vous cliquez sur le verbe Supprimer le composant WebPart dans le menu, le contrôle est définitivement supprimé et le instance supprimé ne peut pas être rajouté à la page. Toutefois, vous pouvez retourner la page en mode d’affichage catalogue et ajouter une nouvelle instance du TextDisplayWebPart contrôle.

Remarques

Le verbe delete référencé par la DeleteVerb propriété apparaît dans le menu déroulant des verbes de la barre de titre de chaque contrôle dynamique WebPart d’une zone. Le verbe supprimer n’est pas disponible sur les contrôles statiques (contrôles déclarés dans le balisage de la page Web). Le verbe apparaît dans le menu verbes uniquement lorsque la page est en mode d’affichage qui vous permet de modifier la mise en page, par CatalogDisplayMode exemple ou DesignDisplayMode.

La suppression d’un contrôle supprime définitivement le instance de ce contrôle d’une page. Contrairement à un contrôle fermé, une instance supprimée d’un contrôle ne peut jamais être rajoutée à une page. Lorsqu’un utilisateur supprime un contrôle, puis bascule une page en CatalogDisplayMode, si la CatalogZone zone contient un PageCatalogPart contrôle, le contrôle supprimé instance n’est pas disponible dans celui-ci. L’utilisateur peut ajouter une nouvelle instance d’un contrôle, si le contrôle est disponible dans le catalogue, mais que le instance supprimé a été supprimé définitivement.

S’applique à

Voir aussi