WebPartZoneBase.CloseVerb 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 cerrar los controles WebPart de una zona.
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.WebPartVerbPublic Overridable ReadOnly Property CloseVerb As WebPartVerbValor de propiedad
WebPartVerb que permite a los usuarios finales cerrar controles WebPart.
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra el uso de la CloseVerb 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 de ayuda 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. Observe que el elemento declarativo <CloseVerb> de la zona establece el texto específico que representa el verbo close en el menú 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>
Observe también que, dado que el control personalizado subyacente WebPart denominado TextDisplayWebPart, que se usa en el ejemplo de código establece la AllowClose propiedad false en en su constructor, el <aspSample:TextDisplayPart> elemento del catálogo debe establecer la AllowClose propiedad trueen , para que el control se pueda cerrar en el ejemplo de código siguiente.
<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>
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 close, y puede hacer clic en el verbo Cerrar elemento web en el menú verbos para cerrar el control. Después de cerrar el control, si devuelve la página al modo de presentación del catálogo, puede hacer clic en el Catálogo de páginas, seleccionar la instancia original del TextDisplayWebPart control que ha cerrado y volver a abrirla en la página.
Comentarios
El verbo close al que hace referencia la CloseVerb propiedad aparece en el menú verbos de cada WebPart control de una zona.
Cerrar un control lo quita de la interacción en una página, aunque si los desarrolladores proporcionan la interfaz de usuario (UI) adecuada, como una CatalogZone zona que contiene un PageCatalogPart control, un usuario puede cambiar la página a CatalogDisplayMode y agregar una instancia cerrada previamente de un control a la página.
