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 класса.

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

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

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

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