EditorZoneBase.CancelVerb 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

获取对 WebPartVerb 对象的引用，该对象使最终用户能够取消在编辑模式下对控件所做的编辑更改。

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

属性值

WebPartVerb

WebPartVerb 允许最终用户取消对控件所做的编辑更改。

属性
PersistenceModeAttribute

示例

下面的代码示例演示如何以声明方式和编程方式访问 CancelVerb 属性。 有关运行示例所需的完整代码，请参阅类概述主题的示例 EditorZoneBase 部分。

代码示例的第一部分演示如何在网页中以声明方式访问 CancelVerb 属性。 此示例自定义谓词的文本。

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

本示例的第二部分演示如何通过使用切换按钮启用或禁用属性，以编程方式访问 CancelVerb 属性。

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

在浏览器中加载页面时，可以在下拉列表控件中选择 “编辑模式 ”以切换到编辑模式。 可以单击其中一个控件标题栏中的向下箭头) (谓词菜单，然后单击“ 编辑 ”编辑所选控件。 EditorZone当控件和编辑 UI 可见时，可以看到表示取消谓词的按钮，然后单击“切换取消”“已启用”按钮启用或禁用它。

注解

取消谓词由 CancelVerb 派生自 EditorZoneBase 类的控件上的 属性引用。 取消谓词取消最终用户在编辑用户界面 (UI) 中对服务器控件进行的编辑更改。 默认情况下，取消谓词在 UI 中显示为控件 Button 。 按钮的类型可以是图像、链接或实际按钮;可以通过在区域级别设置继承 VerbButtonType 的属性，为区域中的所有谓词按钮设置此 (不适用于) 的各个按钮。

当用户取消编辑更改时，控件中的 EditorPart 任何更改都不会应用于正在编辑的服务器控件。 此外，页面仍处于编辑显示模式，但 EditorPart 控件处于隐藏状态， WebPart 并且不再选择正在编辑的控件。 这允许最终用户选择要编辑的另一个 WebPart 控件，而无需再次更改显示模式。

取消谓词是一个区域级控件，这意味着，虽然可能 EditorPart 有多个控件，但每个控件都编辑处于编辑模式的服务器控件的一个或多个属性，取消谓词可普遍取消区域中所有 EditorPart 控件的所有更改。

适用于

另请参阅