WebPartZoneBase.DeleteVerb Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Получает ссылку на объект WebPartVerb, который позволяет конечным пользователям удалять элементы управления WebPart в зоне.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ DeleteVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb DeleteVerb { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DeleteVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property DeleteVerb As WebPartVerb

Значение свойства

WebPartVerb

Объект WebPartVerb, который позволяет конечным пользователям удалять элементы управления WebPart.

Атрибуты
PersistenceModeAttribute

Примеры

В следующем примере кода показано использование свойства в DeleteVerb элементе WebPartZone управления . Чтобы пример кода работал, вам потребуется весь код из раздела HelpVerb Пример свойства .

Следующая часть примера кода относится к разделяемму классу и содержит код, который переключает, включена или отключена команда удаления.

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

Другая часть примера кода — веб-страница, на которую размещается пользовательский элемент управления и который содержит пользовательский интерфейс. Обратите внимание, что декларативный <DeleteVerb> элемент в зоне задает конкретный текст, представляющий команду удаления, в раскрывающемся меню глаголов для WebPart элемента управления .

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

После загрузки страницы в браузере переключите страницу в режим отображения каталога и добавьте TextDisplayWebPart элемент управления на страницу. Вы можете использовать поля проверка, чтобы включить и отключить команду удаления в TextDisplayWebPart элементе управления, но глагол отображается в меню только в режиме отображения каталога или конструктора. Если щелкнуть команду Удалить веб-часть в меню, элемент управления будет окончательно удален, а удаленный экземпляр не может быть добавлен обратно на страницу. Однако можно вернуть страницу в режим отображения каталога и добавить новый экземпляр TextDisplayWebPart элемента управления .

Комментарии

Команда удаления, на которую DeleteVerb ссылается свойство , отображается в раскрывающемся меню глаголов в строке заголовка каждого динамического WebPart элемента управления в зоне. Команда удаления недоступна в статических элементах управления (элементах управления, объявленных в разметке веб-страницы). Команда отображается в меню команд, только если страница находится в режиме отображения, который позволяет изменить макет страницы, например CatalogDisplayMode или DesignDisplayMode.

При удалении элемента управления экземпляр этого элемента управления удаляется со страницы без возможности восстановления. В отличие от закрытого элемента управления удаленный экземпляр элемента управления никогда не может быть добавлен обратно на страницу. Когда пользователь удаляет элемент управления, а затем переключает страницу на CatalogDisplayMode, если CatalogZone зона содержит PageCatalogPart элемент управления, удаленный экземпляр элемента управления недоступен в нем. Пользователь может добавить новый экземпляр элемента управления, если элемент управления доступен в каталоге, но удаленный экземпляр удален без возможности восстановления.

Применяется к

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