Export (0) Print
Expand All

EditorZoneBase.CancelVerb Property

Gets a reference to a WebPartVerb object that enables end users to cancel editing changes to a control in edit mode.

Namespace:  System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public virtual WebPartVerb CancelVerb { get; }

Property Value

Type: System.Web.UI.WebControls.WebParts.WebPartVerb
A WebPartVerb that enables end users to cancel editing changes to a control.

The cancel verb is referenced by the CancelVerb property on a control derived from the EditorZoneBase class. The cancel verb cancels editing changes that an end user has made to a server control in the editing user interface (UI). By default, the cancel verb appears in the UI as a Button control. The type of button can be an image, a link, or an actual button; you can set this for all verb buttons in a zone (not for individual buttons) by setting the inherited VerbButtonType property at the zone level.

When a user cancels editing changes, none of the changes in the EditorPart controls are applied to the server control that is being edited. In addition, the page remains in edit display mode, but the EditorPart controls are hidden and the WebPart control that was being edited is no longer selected. This allows an end user to select another WebPart control to edit without having to change display modes again.

The cancel verb is a zone-level control, meaning that while there might be several EditorPart controls, each editing one or more properties for the server control that is in edit mode, the cancel verb works universally to cancel all changes from all the EditorPart controls in the zone.

The following code example demonstrates how to access the CancelVerb property both declaratively and programmatically. For the full code required to run the example, see the Example section of the EditorZoneBase class overview topic.

The first part of the code example shows how to access the CancelVerb property declaratively in a Web page. This example customizes the text for the verb.


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


The second part of the example shows how to access the CancelVerb property programmatically, by using a toggle button to enable or disable it.


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


When you load the page in a browser, you can select Edit Mode in the drop-down list control to switch to edit mode. You can click the verbs menu (the down arrow) in the title bar of one of the controls, and click Edit to edit the selected control. When the EditorZone control and editing UI are visible, you can see the button that represents the cancel verb, and click the Toggle CancelVerb Enabled button to enable or disable it.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft