WebPartZoneBase.DeleteVerb Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.WebPartVerbPublic Overridable ReadOnly Property DeleteVerb As WebPartVerbValor 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.
