WebPartZoneBase.DeleteVerb Propiedad

Definición

Obtiene una referencia a un objeto WebPartVerb que permite a los usuarios finales eliminar los controles WebPart de una zona.

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

Valor de propiedad

WebPartVerb que permite a los usuarios finales eliminar controles WebPart.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la DeleteVerb propiedad en un WebPartZone control . Para que el ejemplo de código funcione, necesita todo el código de la sección Ejemplo de la HelpVerb propiedad .

La siguiente parte del ejemplo de código procede de la clase parcial y contiene el código que alterna si el verbo delete está habilitado o deshabilitado.

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

La otra parte del ejemplo de código es la página web que hospeda el control personalizado y contiene la interfaz de usuario (UI). Observe que el elemento declarativo <DeleteVerb> de la zona establece el texto específico que representa el verbo delete en el menú desplegable verbos del WebPart control.

<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>

Después de cargar la página en un explorador, cambie la página al modo de presentación del catálogo y agregue el TextDisplayWebPart control a la página. Puede usar las casillas para habilitar y deshabilitar el verbo delete en el TextDisplayWebPart control, pero el verbo aparece en el menú solo mientras la página está en modo de presentación de catálogo o diseño. Si hace clic en el verbo Eliminar elemento web en el menú, el control se elimina permanentemente y la instancia eliminada no se puede volver a agregar a la página. Sin embargo, puede devolver la página al modo de presentación del catálogo y agregar una nueva instancia del TextDisplayWebPart control.

Comentarios

El verbo delete al que hace referencia la DeleteVerb propiedad aparece en el menú desplegable verbos de la barra de título de cada control dinámico WebPart de una zona. El verbo delete no está disponible en controles estáticos (controles declarados en el marcado de la página web). El verbo aparece en el menú verbos solo cuando la página está en un modo de presentación que permite cambiar el diseño de página, como CatalogDisplayMode o DesignDisplayMode.

Al eliminar un control, se quita permanentemente la instancia de ese control de una página. A diferencia de un control cerrado, una instancia eliminada de un control nunca se puede volver a agregar a una página. Cuando un usuario elimina un control y, a continuación, cambia una página a CatalogDisplayMode, si la CatalogZone zona contiene un PageCatalogPart control, la instancia de control eliminada no está disponible en él. El usuario puede agregar una nueva instancia de un control, si el control está disponible en el catálogo, pero la instancia eliminada se ha quitado permanentemente.

Se aplica a

Consulte también