EditorZoneBase.CancelVerb Propiedad

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls.WebParts

Ensamblado:: System.Web.dll

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 cancelar los cambios de edición a un control en modo de edición.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CancelVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CancelVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CancelVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property CancelVerb As WebPartVerb

Valor de propiedad

WebPartVerb

Un objeto WebPartVerb que permite a los usuarios finales cancelar los cambios de edición de un control.

Atributos: PersistenceModeAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo obtener acceso a la CancelVerb propiedad mediante declaración y mediante programación. Para obtener el código completo necesario para ejecutar el ejemplo, vea la sección Ejemplo del tema de información general de la EditorZoneBase clase.

La primera parte del ejemplo de código muestra cómo obtener acceso a la CancelVerb propiedad mediante declaración en una página web. En este ejemplo se personaliza el texto del verbo.

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

En la segunda parte del ejemplo se muestra cómo obtener acceso a la CancelVerb propiedad mediante programación, mediante un botón de alternancia para habilitarla o deshabilitarla.

void Button2_Click(object sender, EventArgs e)
{
  if (EditorZone1.CancelVerb.Enabled)
    EditorZone1.CancelVerb.Enabled = false;
  else
    EditorZone1.CancelVerb.Enabled = true;
}

Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
  If EditorZone1.CancelVerb.Enabled Then
    EditorZone1.CancelVerb.Enabled = False
  Else
    EditorZone1.CancelVerb.Enabled = True
  End If
End Sub

Al cargar la página en un explorador, puede seleccionar Modo de edición en el control de lista desplegable para cambiar al modo de edición. Puede hacer clic en el menú verbos (la flecha abajo) en la barra de título de uno de los controles y hacer clic en Editar para editar el control seleccionado. Cuando el control y la EditorZone interfaz de usuario de edición están visibles, puede ver el botón que representa el verbo cancelar y hacer clic en el botón Alternar CancelVerb habilitado para habilitarlo o deshabilitarlo.

Comentarios

La propiedad de un control derivado de la clase hace referencia CancelVerb al EditorZoneBase verbo cancel. El verbo cancel cancela los cambios de edición realizados por un usuario final en un control de servidor en la interfaz de usuario (UI) de edición. De forma predeterminada, el verbo cancel aparece en la interfaz de usuario como un Button control. El tipo de botón puede ser una imagen, un vínculo o un botón real; puede establecer esto para todos los botones de verbo de una zona (no para botones individuales) estableciendo la propiedad heredada VerbButtonType en el nivel de zona.

Cuando un usuario cancela los cambios de edición, ninguno de los cambios de los EditorPart controles se aplica al control de servidor que se está editando. Además, la página permanece en modo de presentación de edición, pero los EditorPart controles están ocultos y el WebPart control que se está editando ya no está seleccionado. Esto permite a un usuario final seleccionar otro WebPart control para editar sin tener que volver a cambiar los modos de presentación.

El verbo cancel es un control de nivel de zona, lo que significa que, aunque puede haber varios EditorPart controles, cada una de las propiedades de edición del control de servidor que está en modo de edición, el verbo cancel funciona universalmente para cancelar todos los cambios de todos los EditorPart controles de la zona.

Se aplica a

Compartir vía