WebPartZoneBase.CloseVerb Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает ссылку на объект WebPartVerb, который позволяет конечным пользователям закрывать элементы управления WebPart в зоне.
public:
virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CloseVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CloseVerb { get; }[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CloseVerb : System.Web.UI.WebControls.WebParts.WebPartVerbPublic Overridable ReadOnly Property CloseVerb As WebPartVerbЗначение свойства
Объект WebPartVerb, который позволяет конечным пользователям закрывать элементы управления WebPart.
- Атрибуты
Примеры
В следующем примере кода показано использование свойства в CloseVerb элементе 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
Другая часть примера кода — это веб-страница, на которую размещается пользовательский элемент управления и содержится пользовательский интерфейс. Обратите внимание, что декларативный <CloseVerb> элемент в зоне задает конкретный текст, представляющий команду закрытия в меню команд для 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>
Обратите также внимание, что, поскольку базовый пользовательский WebPart элемент управления с именем TextDisplayWebPart, используемый в примере кода, задает AllowClose свойству false значение в конструкторе, <aspSample:TextDisplayPart> элемент в каталоге AllowClose должен присвоить свойству trueзначение , чтобы элемент управления можно было закрыть в следующем примере кода.
<asp:CatalogZone ID="CatalogZone1" Runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"
Runat="server">
<WebPartsTemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
AllowClose="true"
ExportMode="All"
HelpMode="Modal"
HelpUrl="TextWebPartHelp.htm" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
<asp:CatalogZone ID="CatalogZone1" Runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"
Runat="server">
<WebPartsTemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
AllowClose="true"
ExportMode="All"
HelpMode="Modal"
HelpUrl="TextWebPartHelp.htm" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
После загрузки страницы в браузере переключите страницу в режим отображения каталога и добавьте TextDisplayWebPart элемент управления на страницу. С помощью флажков можно включить и отключить команду закрытия, а также щелкнуть команду Закрыть веб-часть в меню команд, чтобы закрыть элемент управления . Если после закрытия элемента управления вернуть страницу в режим отображения каталога, можно щелкнуть каталог страниц, выбрать исходный TextDisplayWebPart экземпляр элемента управления, который вы закрыли, и снова открыть его на странице.
Комментарии
Команда закрытия, на которую CloseVerb ссылается свойство , отображается в меню команд каждого WebPart элемента управления в зоне.
Закрытие элемента управления удаляет его из взаимодействия со страницей, хотя если разработчики предоставляют соответствующий пользовательский интерфейс, например CatalogZone зону, содержащую PageCatalogPart элемент управления, пользователь может переключить страницу на страницу CatalogDisplayMode и добавить ранее закрытый экземпляр элемента управления на страницу.
