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 Когда элемент управления и пользовательский интерфейс редактирования видны, вы увидите кнопку, представляющую команду отмены, и нажмите кнопку Включить ОтменаВерб, чтобы включить или отключить ее.

Комментарии

На команду cancel ссылается CancelVerb свойство элемента управления, производного от EditorZoneBase класса . Команда отмены отменяет изменения, внесенные конечным пользователем в серверный элемент управления в пользовательском интерфейсе редактирования. По умолчанию команда cancel отображается в пользовательском интерфейсе Button как элемент управления. Тип кнопки может быть изображением, ссылкой или фактической кнопкой; Его можно задать для всех кнопок глаголов в зоне (а не для отдельных кнопок), задав наследуемое VerbButtonType свойство на уровне зоны.

Когда пользователь отменяет изменения, ни одно из изменений в EditorPart элементах управления не применяется к редактируемой серверной элементу управления. Кроме того, страница остается в режиме отображения правки, но EditorPart элементы управления скрыты, а редактируемый WebPart элемент управления больше не выбирается. Это позволяет пользователю выбрать другой WebPart элемент управления для редактирования без повторного изменения режимов отображения.

Команда отмены является элементом управления на уровне зоны. Это означает, что хотя может быть несколько EditorPart элементов управления, каждый из которых изменяет одно или несколько свойств для серверного элемента управления в режиме редактирования, команда отмены работает универсально, чтобы отменить все изменения из всех EditorPart элементов управления в зоне.

См. также раздел

• WebPartVerb
• элементы управления веб-частей ASP.NET