CatalogZone Класс

Определение

public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBase

public class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBase

type CatalogZone = class
    inherit CatalogZoneBase

Public Class CatalogZone
Inherits CatalogZoneBase

Наследование

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

CatalogZone

Примеры

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

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

• Файл с исходным кодом для пользовательского элемента управления, а также пользовательский CatalogZoneWebPart элемент управления, импортированный каталогом и добавленный на веб-страницу.

• Веб-страница, которая объявляет элемент управления пользователем и пользовательский CatalogZone элемент управления.

• Описание запуска примера.

Первая часть этого примера кода — это пользовательский элемент управления, позволяющий пользователям изменять режимы отображения на веб-странице. Дополнительные сведения о режимах отображения и описании исходного кода в этом элементе управления см. в пошаговом руководстве. Изменение режимов отображения на странице веб-частей.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

Вторая часть примера кода содержит код для пользовательских CatalogZone и WebPart элементов управления. В коде CatalogZone элемента управления показано, как наследовать от CatalogZone класса и настроить его свойства, задав некоторые значения свойств по умолчанию в конструкторе. Исходный код также демонстрирует создание пользовательского WebPart класса с именем TextDisplayWebPart. Это элемент управления, связанный с элементом управления . Файл описания веб-части, который вы импортируете в рамках этого примера кода. После импорта файла описания с помощью ImportCatalogPart элемента управления на веб-странице вы сможете добавить TextDisplayWebPart элемент управления на страницу, полностью настроенную, как указано в файле описания.

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

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  // Create a customized CatalogZone control by setting 
  // some properties in the constructor.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyCatalogZone : CatalogZone
  {
    public MyCatalogZone()
    {
      this.HeaderText = "My Company Catalog";
      this.HeaderCloseVerb.Text = "Close Catalog";
      this.CloseVerb.Text = "Close Catalog";
    }
  }

  // Create a custom WebPart control to add to a WebPartZone.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  ' Create a custom CatalogZone control by setting some 
  ' properties in the constructor.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class MyCatalogZone
    Inherits CatalogZone

    Public Sub New()
      Me.HeaderText = "My Company Catalog"
      Me.HeaderCloseVerb.Text = "Close Catalog"
      Me.CloseVerb.Text = "Close Catalog"
    End Sub

  End Class


  ' Create a custom WebPart to add to a WebPartZone.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      input = New TextBox()
      Me.Controls.Add(input)
      Dim update As New Button()
      update.Text = "Set Label Content"
      AddHandler update.Click, AddressOf Me.submit_Click
      Me.Controls.Add(update)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If input.Text <> String.Empty Then
        _contentText = input.Text + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

Третья часть примера кода — веб-страница, содержащая элементы управления. Он содержит директиву Register для пользовательского элемента управления, а другой — для исходного файла с пользовательскими элементами управления. Обратите внимание, что во второй директиве сборка не называется, так как в примере не используется сборка, она использует динамическую компиляцию с исходным кодом, помещенным в вложенную папку App_Code. Веб-страница объявляет WebPartZone элемент управления и в его дочернем <zonetemplate> элементе BulletedList объявляет элемент управления. Хотя это стандартный элемент управления ASP.NET, он будет иметь полную функциональность веб-частей во время выполнения, так как WebPartManager элемент управления упаковывает любой серверный элемент управления, размещенный в объекте, чтобы другие серверные элементы управления могли участвовать в WebPartZoneGenericWebPart веб-частях приложений. Кроме того, в этой зоне объявлен пользовательский WebPart элемент управления TextDisplayWebPart. Обратите внимание, что этот элемент управления имеет атрибут объявленного ExportMode="All" в нем элемента управления. Это позволяет экспортировать объект . Файл описания веб-части, содержащий значения свойств элемента управления, который можно импортировать другими пользователями, чтобы добавить предварительно настроенный элемент управления на другие веб-страницы.

Веб-страница также объявляет пользовательский CatalogZone элемент управления и, в нем, элемент, <zonetemplate> содержащий ImportCatalogPart элемент управления. Пользователь будет использовать этот элемент управления во время выполнения для импорта. Файл описания веб-части для пользовательского WebPart элемента управления.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.CS.Controls" %> 
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.VB.Controls"  %> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

Теперь запустите пример кода. Загрузите веб-страницу в браузере. Первым шагом является экспорт . Файл описания веб-части элемента TextDisplayWebPart управления. Щелкните меню команд в пользовательском элементе управления (представленное стрелкой вниз в строке заголовка) и нажмите кнопку "Экспорт". Следуйте инструкциям, чтобы сохранить файл описания для элемента управления. Откройте файл . Файл описания веб-части в редакторе и изменение значения текста свойства заголовка. <property> Найдите элемент с атрибутом name="Title"и измените текст заголовка, содержащийся между открывающими и закрывающими <property> тегами. Теперь закройте веб-страницу и измените источник страницы в редакторе. <aspSample:TextDisplayWebPart> Удалите элемент объявления элемента управления, а затем сохраните и закройте файл.

Снова загрузите веб-страницу в браузере. Элемент TextDisplayWebPart управления не должен отображаться, так как вы удалили его. Используйте раскрывающийся список " Режим отображения " и выберите "Каталог ", чтобы переключить страницу в режим каталога. Обратите внимание, что пользовательский CatalogZone элемент управления отображается вместе с элементом ImportCatalogPart управления. Нажмите кнопку "Обзор ", чтобы найти ее. Файл описания веб-части, экспортируемый TextDisplayWebPart для элемента управления. Щелкните " Отправить", установите флажок рядом с импортированным элементом управления и нажмите кнопку "Добавить ", чтобы добавить ее на страницу. Нажмите кнопку "Закрыть каталог" , чтобы вернуть страницу в обычный режим обзора. Импортированный элемент управления должен отображаться на странице, а заголовок, который отображается в строке заголовка элемента управления, должен быть текст заголовка, добавленный в элемент управления. Файл описания веб-части.

Комментарии

В наборе элементов управления веб-частей зона — это регион на веб-странице, содержащей элементы управления веб-частей. Зона веб-частей создается элементом управления зонами, который является типом, предназначенным CompositeControl для хранения других элементов управления. Основными функциями зоны являются создание элементов управления, содержащихся в ней, и предоставление общего пользовательского интерфейса для этих элементов управления. Общие сведения о зонах и их использовании в приложениях веб-частей см. в базовом WebZone классе и обзоре набора элементов управления веб-частями.

Ключевой особенностью элементов управления веб-частей является то, что пользователи могут изменять веб-страницы (или персонализировать) в соответствии с их предпочтениями и сохранять персонализированные параметры для будущих сеансов браузера. Один из аспектов изменения страниц веб-частей включает возможность добавлять WebPart элементы управления или другие серверные элементы управления на страницу веб-частей. Элемент CatalogZone управления предоставляет список или каталог элементов управления, которые пользователи могут добавлять на страницу.

Элемент CatalogZone управления является одним из основных элементов управления в наборе элементов управления веб-частей. Он является производным от CatalogZoneBase класса, и большая часть его поведения наследуется от этого класса. Класс CatalogZone по сути добавляется в базовый класс шаблон зоны, который является реализацией ITemplate интерфейса. Шаблон зоны позволяет разработчикам декларативно добавлять CatalogPart элементы управления в зону в формате сохраняемости страницы.

Элемент CatalogZone управления становится видимым, только если пользователь переключает веб-страницу на режим отображения каталога (CatalogDisplayMode). Каталог может содержать несколько типов CatalogPart элементов управления. Каждый CatalogPart элемент управления — это тип контейнера, содержащего пользователи серверных элементов управления, которые могут добавляться на страницу. Элементы CatalogPart управления отличаются в зависимости от того, откуда они относятся к элементам управления сервера. В следующей таблице перечислены CatalogPart элементы управления, предоставляемые набором элементов управления веб-частей, и для каждого элемента управления, какой тип элементов управления он содержит.

CatalogZone Так как класс добавляет только шаблон зоны в поведение базового класса, он имеет несколько членов. Конструктор — это конструктор без параметров. С CatalogZone ним можно инициализировать новый экземпляр CatalogZone класса. Свойство ZoneTemplate получает или задает ссылку на ITemplate объект, содержащий элементы управления для зоны. Метод CreateCatalogParts является критически важным. Он переопределяет базовый метод для создания коллекции всех CatalogPart элементов управления, содержащихся в шаблоне зоны.

Доступность

Разметка, отображаемая по умолчанию для этого элемента управления, может не соответствовать стандартам специальных возможностей, таким как рекомендации по специальным возможностям веб-содержимого 1.0 (WCAG) приоритет 1. Дополнительные сведения о поддержке специальных возможностей для этого элемента управления см. в ASP.NET элементах управления и специальных возможностях.

Примечания для тех, кто наследует этот метод

Можно создать пользовательские CatalogZone классы, если требуется больше контроля над отрисовкой и поведением пользовательского интерфейса каталога. Если вам не нужно предоставлять пользователям элемента управления возможность добавлять CatalogPart элементы управления декларативно, можно наследовать непосредственно от CatalogZoneBase класса. Если вы хотите включить декларативное добавление элементов управления, простой подход заключается в наследовании от класса, так как он предоставляет шаблон основной CatalogZone зоны.

Если вы наследуете от CatalogZone класса, можно переопределить CreateCatalogParts() метод и использовать метод для добавления пользовательских элементов управления в нееCatalogPartCollection, если требуется более широкий программный контроль над добавлением настраиваемых CatalogPartCatalogPart элементов управления в зону.

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

• CatalogPart
• Обзор набора элементов управления веб-частей
• Обзор персонализации веб-частей
• элементы управления веб-частей ASP.NET