WebPartZoneBase.DeleteVerb Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает ссылку на объект 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.WebPartVerbPublic Overridable ReadOnly Property DeleteVerb As WebPartVerbЗначение свойства
Объект WebPartVerb, который позволяет конечным пользователям удалять элементы управления WebPart.
- Атрибуты
Примеры
В следующем примере кода показано использование свойства в DeleteVerb элементе WebPartZone управления . Чтобы пример кода работал, вам потребуется весь код из раздела HelpVerb Example свойства .
Следующая часть примера кода получена из разделяемого класса и содержит код, который переключает включение или отключение команды удаления.
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 элемент управления, удаленный экземпляр элемента управления недоступен. Пользователь может добавить новый экземпляр элемента управления, если элемент управления доступен в каталоге, но удаленный экземпляр удален окончательно.
