WebPartZoneBase.CloseVerb Свойство

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

Public Overridable ReadOnly Property CloseVerb As WebPartVerb

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

Это WebPartVerb позволяет конечным пользователям закрывать WebPart элементы управления.

Атрибуты

PersistenceModeAttribute

Примеры

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

<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 элемент управления на страницу. Флажки можно использовать для включения и отключения команды закрытия и нажатия команды Close WebPart в меню команд, чтобы закрыть элемент управления. После закрытия элемента управления при возврате страницы в режим отображения каталога можно щелкнуть каталог страниц, выбрать исходный экземпляр закрытого TextDisplayWebPart элемента управления и повторно открыть его на странице.

Комментарии

Закрываемая команда, на которую CloseVerb ссылается свойство, отображается в меню команд каждого WebPart элемента управления в зоне.

Закрытие элемента управления удаляет его из взаимодействия на странице, хотя если разработчики предоставляют соответствующий пользовательский интерфейс(пользовательский интерфейс), например CatalogZone зону, содержащую PageCatalogPart элемент управления, пользователь может переключить страницу CatalogDisplayMode на страницу и добавить ранее закрытый экземпляр элемента управления обратно на страницу.

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

• CloseWebPart(WebPart)
• DeleteVerb
• элементы управления веб-частей ASP.NET