CatalogZoneBase.CloseVerb Свойство

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Возвращает ссылку на объект WebPartVerb, который позволяет конечным пользователям закрывать пользовательский интерфейс каталога и переключать страницу в обычный режим отображения.

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

Объект WebPartVerb, который позволяет конечным пользователям закрывать пользовательский интерфейс каталога на веб-странице.

Атрибуты

PersistenceModeAttribute

Примеры

В следующем примере кода показано, как получить доступ к свойству CloseVerb как декларативно, так и программно. Полный код, необходимый для выполнения примера, см. в разделе CatalogZoneBase Пример обзора класса.

В первой части примера кода показано, как получить доступ к свойству CloseVerb декларативно на веб-странице. В этом примере настраивается Description свойство для команды .

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

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

protected void Button1_Click(object sender, EventArgs e)
{
  if (CatalogZone1.AddVerb.Enabled)
  {
    CatalogZone1.AddVerb.Enabled = false;
    CatalogZone1.CloseVerb.Enabled = false;
  }
  else
  {
    CatalogZone1.AddVerb.Enabled = true;
    CatalogZone1.CloseVerb.Enabled = true;
  }
}

Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  If CatalogZone1.AddVerb.Enabled Then
    CatalogZone1.AddVerb.Enabled = False
    CatalogZone1.CloseVerb.Enabled = False
  Else
    CatalogZone1.AddVerb.Enabled = True
    CatalogZone1.CloseVerb.Enabled = True
  End If

End Sub

При загрузке страницы в браузере можно выбрать Каталог из раскрывающегося списка, чтобы переключиться в режим отображения каталога. Когда каталог виден, наведите указатель мыши на кнопку Закрыть , вы увидите текст его описания в подсказке. Вы также можете нажать кнопку Включить или Отключить команды , чтобы продемонстрировать, что вы можете получить доступ к команде закрытия программным способом.

Комментарии

На команду close ссылается CloseVerb свойство элемента управления, производного от CatalogZoneBase класса .

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

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

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

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