CatalogZone Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls.WebParts

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Служит основным элементом управления в наборе элементов управления веб-частей для размещения элементов управления CatalogPart на веб-странице.

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 элемента управления . Пример кода состоит из четырех частей:

Пользовательский элемент управления, позволяющий изменять режимы отображения на веб-странице.
Файл с исходным кодом для пользовательского CatalogZone элемента управления и настраиваемым WebPart элементом управления, импортированным каталогом и добавленным на веб-страницу.
Веб-страница, объявляющая пользовательский элемент управления и пользовательский 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 элемент управления заключает в оболочку любой серверный элемент управления, помещенный WebPartZone в , с GenericWebPart объектом , чтобы другие серверные элементы управления могли участвовать в приложениях веб-частей. Кроме того, в этой зоне объявлен пользовательский WebPart элемент управления с именем TextDisplayWebPart. Обратите внимание, что в этом элементе управления объявлен атрибут .ExportMode="All" Это позволяет экспортировать . Файл описания веб-части, содержащий значения свойств элемента управления, которые могут быть импортированы другими пользователями для добавления предварительно настроенного элемента управления на другие веб-страницы.

Примечание

Чтобы пользователи приложения веб-частей могли экспортировать файл описания для WebPart элементов управления, необходимо также включить функцию экспорта в веб-приложении, добавив enableExport="true" атрибут к элементу <webParts> (который является дочерним <system.web> для элемента) в файле Web.config. Экспорт отключен по умолчанию, поэтому, если вы еще не включили экспорт для приложения, измените файл Web.config и сделайте это сейчас.

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

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

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

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

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

Важно!

Зона CatalogZone может содержать только CatalogPart элементы управления, и наоборот, CatalogPart элементы управления могут находиться только в зонах, производных от CatalogZoneBase класса , таких как CatalogZone.

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

Control	Описание
PageCatalogPart	Сохраняет ссылки на элементы управления, которые были закрыты на странице. Эти элементы управления могут быть повторно открыты (добавлены на страницу) пользователями.
DeclarativeCatalogPart	Содержит ссылки на элементы управления, объявленные в каталоге веб-частей в разметке веб-страницы. Эти элементы управления могут добавляться на веб-страницу пользователями.
ImportCatalogPart	Предоставляет пользователю пользовательский интерфейс для отправки файла определения (XML-файла с . Расширение WebPart и указанный формат, содержащий сведения о состоянии) для элемента управления в каталоге, чтобы элемент управления можно было добавить на веб-страницу.

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

Примечание

Для правильной работы кнопок в пользовательском CatalogZone интерфейсе требуются клиентские скрипты. Если скрипты отключены в браузере, пользователь не сможет выполнять действия через CatalogZone пользовательский интерфейс.

Специальные возможности

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

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

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

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

Конструкторы

CatalogZone()

Инициализирует новый экземпляр класса CatalogZone.

Свойства

AccessKey	Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl)
Adapter	Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control)
AddVerb	Получает ссылку на объект WebPartVerb, который позволяет конечным пользователям добавлять элементы управления из каталога на страницу веб-частей. (Унаследовано от CatalogZoneBase)
AppRelativeTemplateSourceDirectory	Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control)
AssociatedDisplayModes	Получает коллекцию объектов WebPartDisplayMode, которые сопоставлены с некоторой зоной ToolZone. (Унаследовано от ToolZone)
Attributes	Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl)
BackColor	Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl)
BackImageUrl	Получает или задает URL-адрес фонового изображения для зоны. (Унаследовано от WebZone)
BindingContainer	Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control)
BorderColor	Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl)
BorderStyle	Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl)
BorderWidth	Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl)
CatalogPartChrome	Получает ссылку на экземпляр класса CatalogPartChrome, который сопоставлен с зоной CatalogZoneBase. (Унаследовано от CatalogZoneBase)
CatalogParts	Получает коллекцию всех элементов управления CatalogPart, содержащихся в зоне CatalogZoneBase. (Унаследовано от CatalogZoneBase)
ChildControlsCreated	Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control)
ClientID	Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control)
ClientIDMode	Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control)
ClientIDSeparator	Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control)
CloseVerb	Возвращает ссылку на объект WebPartVerb, который позволяет конечным пользователям закрывать пользовательский интерфейс каталога и переключать страницу в обычный режим отображения. (Унаследовано от CatalogZoneBase)
Context	Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control)
Controls	Возвращает объект ControlCollection, содержащий дочерние элементы CompositeControl. (Унаследовано от CompositeControl)
ControlStyle	Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl)
ControlStyleCreated	Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl)
CssClass	Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl)
DataItemContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control)
DataKeysContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control)
DesignMode	Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control)
Display	Получает значение, показывающее, отображается ли в текущий момент элемент управления ToolZone. (Унаследовано от ToolZone)
EditUIStyle	Получает атрибуты стиля для редактируемых элементов управления, содержащихся в элементе управления ToolZone. (Унаследовано от ToolZone)
EmptyZoneText	Получает или задает сообщение, которое появляется, когда в зоне нет элементов управления. (Унаследовано от CatalogZoneBase)
EmptyZoneTextStyle	Получает атрибуты стиля для текста местозаполнителя в пустой зоне. (Унаследовано от WebZone)
Enabled	Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl)
EnableTheming	Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl)
EnableViewState	Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control)
ErrorStyle	Получает атрибуты стиля для отрисовки сообщения об ошибке, которое отображается, если элемент управления WebPart не может быть загружен или создан. (Унаследовано от WebZone)
Events	Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control)
Font	Возвращает свойства шрифта, связанные с серверным веб-элементом управления. (Унаследовано от WebControl)
FooterStyle	Получает атрибуты стиля для содержимого области нижнего колонтитула зоны. (Унаследовано от WebZone)
ForeColor	Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl)
HasAttributes	Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl)
HasChildViewState	Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control)
HasFooter	Получает значение, указывающее, содержится ли в зоне область нижнего колонтитула. (Унаследовано от WebZone)
HasHeader	Получает значение, указывающее, содержит ли зона область заголовка. (Унаследовано от WebZone)
HeaderCloseVerb	Получает ссылку на объект WebPartVerb в верхнем колонтитуле зоны ToolZone, который используется для закрытия элемента управления. (Унаследовано от ToolZone)
HeaderStyle	Получает атрибуты стиля для содержимого области заголовка зоны. (Унаследовано от WebZone)
HeaderText	Получает или задает текст для области заголовка зоны. (Унаследовано от CatalogZoneBase)
HeaderVerbStyle	Получает атрибуты стиля для всех команд верхнего колонтитула, отображаемых в элементе управления ToolZone. (Унаследовано от ToolZone)
Height	Получает или задает высоту серверного веб-элемента управления. (Унаследовано от WebControl)
ID	Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control)
IdSeparator	Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control)
InstructionText	Получает или задает текст в зоне, содержащий указания для пользователей. (Унаследовано от CatalogZoneBase)
InstructionTextStyle	Получает атрибуты стиля для текста инструкций, выводящегося в верхней части элемента управления ToolZone. (Унаследовано от ToolZone)
IsChildControlStateCleared	Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control)
IsEnabled	Возвращает значение, определяющее, включен ли элемент управления. (Унаследовано от WebControl)
IsTrackingViewState	Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control)
IsViewStateEnabled	Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control)
LabelStyle	Получает атрибуты стиля для содержимого меток, выводимых рядом с элементами управления редактирования в элементе управления ToolZone. Производные элементы управления ToolZone, такие как CatalogZone и EditorZone, применяют стили к меткам. (Унаследовано от ToolZone)
LoadViewStateByID	Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control)
NamingContainer	Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control)
Padding	Получает или задает атрибуты поля ячейки в таблице зоны, содержащей элементы управления WebPart. (Унаследовано от WebZone)
Page	Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control)
Parent	Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control)
PartChromePadding	Получает или задает расстояние между содержимым элемента управления WebPart и границей элемента управления. (Унаследовано от WebZone)
PartChromeStyle	Получает характеристики стиля, применяемые к границам элементов управления веб-частей, содержащихся в зоне. (Унаследовано от WebZone)
PartChromeType	Получает или задает тип границы, которая обрамляет элементы управления веб-частей, содержащихся в зоне. (Унаследовано от WebZone)
PartLinkStyle	Получает объект, содержащий атрибуты стиля для элементов управления CatalogPart, которые в настоящее время выбраны на странице. (Унаследовано от CatalogZoneBase)
PartStyle	Получает характеристики стиля, которые применяются к границе и содержимому каждого элемента управления веб-частей, содержащегося в зоне. (Унаследовано от WebZone)
PartTitleStyle	Поучает атрибуты стиля для содержимого заголовка окна каждого элемента управления, содержащегося в зоне. (Унаследовано от WebZone)
RenderClientScript	Получает значение, которое указывает, следует ли отрисовывать клиентский скрипт на веб-странице. (Унаследовано от WebZone)
RenderingCompatibility	Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control)
SelectedCatalogPartID	Получает или задает строку в качестве идентификатора текущего выбранного элемента управления CatalogPart в зоне. (Унаследовано от CatalogZoneBase)
SelectedPartLinkStyle	Получает объект, который содержит атрибуты стиля для выбранного в настоящий момент элемента управления CatalogPart в зоне. (Унаследовано от CatalogZoneBase)
SelectTargetZoneText	Получает или задает текст для элемента управления в пользовательском интерфейсе каталога, с помощью которого пользователи могут выбрать, в какую зону можно добавить выбранные элементы управления. (Унаследовано от CatalogZoneBase)
ShowCatalogIcons	Получает или задает значение, указывающее, отображаются ли значки для серверных элементов управления в каталоге. (Унаследовано от CatalogZoneBase)
Site	Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control)
SkinID	Возвращает или задает обложку, применяемую к элементу управления. (Унаследовано от WebControl)
Style	Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl)
SupportsDisabledAttribute	Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута `disabled` отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение `false`. (Унаследовано от CompositeControl)
TabIndex	Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl)
TagKey	Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebZone)
TagName	Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl)
TemplateControl	Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control)
TemplateSourceDirectory	Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control)
ToolTip	Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl)
UniqueID	Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control)
ValidateRequestMode	Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control)
VerbButtonType	Получает или задает тип кнопки, используемый для представления команд в зоне. (Унаследовано от WebZone)
VerbStyle	Получает атрибуты стиля для команд пользовательского интерфейса, связанного с элементами управления веб-частей в зоне. (Унаследовано от WebZone)
ViewState	Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control)
ViewStateIgnoresCase	Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control)
ViewStateMode	Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control)
Visible	Получает или задает значение, определяющее, выводится ли серверный элемент управления на странице в виде элемента пользовательского интерфейса. (Унаследовано от ToolZone)
WebPartManager	Получает ссылку на элемент управления WebPartManager, связанный с экземпляром элемента управления WebZone на странице веб-частей. (Унаследовано от WebZone)
Width	Получает или задает ширину серверного веб-элемента управления. (Унаследовано от WebControl)
ZoneTemplate	Получает или задает шаблон, в котором будут содержаться дочерние элементы управления для элемента управления CatalogZone в формате сохранения страницы.

Методы

AddAttributesToRender(HtmlTextWriter)	Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl)
AddedControl(Control, Int32)	Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control)
AddParsedSubObject(Object)	Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control)
ApplyStyle(Style)	Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl)
ApplyStyleSheetSkin(Page)	Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)	Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control)
BuildProfileTree(String, Boolean)	Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control)
ClearCachedClientID()	Задает для кэшированного свойства ClientID значение `null`. (Унаследовано от Control)
ClearChildControlState()	Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control)
ClearChildState()	Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control)
ClearChildViewState()	Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control)
ClearEffectiveClientIDMode()	Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control)
Close()	Переключает веб-страницу из режима отображения каталога в обычный режим просмотра. (Унаследовано от CatalogZoneBase)
CopyBaseAttributes(WebControl)	Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl)
CreateCatalogPartChrome()	Создает экземпляр объекта CatalogPartChrome, используемого для отрисовки периферийных элементов пользовательского интерфейса для элементов управления CatalogPart в зоне. (Унаследовано от CatalogZoneBase)
CreateCatalogParts()	Создает экземпляр каждого типа CatalogPart, объявленного в зоне.
CreateChildControls()	Создает набор дочерних элементов управления, сопоставленных с зоной CatalogZoneBase. (Унаследовано от CatalogZoneBase)
CreateControlCollection()	Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. (Унаследовано от Control)
CreateControlStyle()	Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl)
DataBind()	Привязывает источник данных к CompositeControl и ко всем его дочерним элементам управления. (Унаследовано от CompositeControl)
DataBind(Boolean)	Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control)
DataBindChildren()	Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control)
Dispose()	Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control)
EndRenderTracing(TextWriter, Object)	Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control)
EnsureChildControls()	Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control)
EnsureID()	Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindControl(String)	Выполняет поиск серверного элемента управления с заданным параметром `id` в текущем контейнере именования. (Унаследовано от Control)
FindControl(String, Int32)	Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным `id` и целым числом, указанным в параметре `pathOffset`, который содействует поиску. Эту версию метода FindControl не следует переопределять. (Унаследовано от Control)
Focus()	Задает фокус ввода на элемент управления. (Унаследовано от Control)
GetDesignModeState()	Возвращает данные времени разработки для элемента управления. (Унаследовано от Control)
GetEffectiveChromeType(Part)	Возвращает фактическое или эффективное текущее значение PartChromeType элемента управления WebPart, учитывая свойство PartChromeType зоны и текущий режим отображения страницы веб-частей. (Унаследовано от WebZone)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRouteUrl(Object)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(String, Object)	Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)	Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetUniqueIDRelativeTo(Control)	Возвращает часть с префиксом свойства UniqueID указанного элемента управления. (Унаследовано от Control)
HasControls()	Определяет наличие у серверного элемента управления дочерних элементов управления. (Унаследовано от Control)
HasEvents()	Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления. (Унаследовано от Control)
InvalidateCatalogParts()	Уничтожает коллекцию элементов управления CatalogPart, связанную с зоной CatalogZoneBase. (Унаследовано от CatalogZoneBase)
IsLiteralContent()	Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control)
LoadControlState(Object)	Загружает состояние из предыдущего запроса страницы для свойств элемента управления, которые должны быть постоянными в обратных запросах, даже если для элемента управления отключено состояние просмотра. (Унаследовано от CatalogZoneBase)
LoadPostData(String, NameValueCollection)	Обрабатывает состояние флажков, соответствующих элементам управления WebPart в каталоге, при обратном запросе страницы на сервер. (Унаследовано от CatalogZoneBase)
LoadViewState(Object)	Загружает ранее сохраненные сведения о состоянии для зоны. (Унаследовано от CatalogZoneBase)
MapPathSecure(String)	Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MergeStyle(Style)	Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl)
OnBubbleEvent(Object, EventArgs)	Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control)
OnDataBinding(EventArgs)	Вызывает событие DataBinding. (Унаследовано от Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать аспекты изменения режимов отображения страницы для специальной зоны. (Унаследовано от ToolZone)
OnInit(EventArgs)	Регистрирует объект страницы, чтобы страница нуждалась в состоянии элемента управления. (Унаследовано от CatalogZoneBase)
OnLoad(EventArgs)	Вызывает событие Load. (Унаследовано от Control)
OnPreRender(EventArgs)	Создает событие PreRender и регистрирует объект страницы, чтобы были необходимы обратные запросы. (Унаследовано от CatalogZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать событие изменения элемента управления веб-частей, выбранного в специальной зоне. (Унаследовано от ToolZone)
OnUnload(EventArgs)	Вызывает событие Unload. (Унаследовано от Control)
OpenFile(String)	Возвращает Stream, используемое для чтения файла. (Унаследовано от Control)
RaiseBubbleEvent(Object, EventArgs)	Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control)
RaisePostBackEvent(String)	Выполняет действия, сопоставленные с одной из команд зоны, или вызывает событие, выполняющее обратную передачу на сервер. (Унаследовано от CatalogZoneBase)
RecreateChildControls()	Воссоздает дочерние элементы элемента управления, являющегося наследником CompositeControl. (Унаследовано от CompositeControl)
RemovedControl(Control)	Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control)
Render(HtmlTextWriter)	Отображает зону в указанном объекте HtmlTextWriter. (Унаследовано от CatalogZoneBase)
RenderBeginTag(HtmlTextWriter)	Отрисовывает HTML-тег открытия элемента управления зоны для указанного объекта HtmlTextWriter. (Унаследовано от WebZone)
RenderBody(HtmlTextWriter)	Переопределяет базовый метод, чтобы отобразить основную область зоны, производной от класса CatalogZoneBase. (Унаследовано от CatalogZoneBase)
RenderCatalogPartLinks(HtmlTextWriter)	Отрисовывает ссылки на отдельные элементы управления CatalogPart в зоне CatalogZoneBase. (Унаследовано от CatalogZoneBase)
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control)
RenderContents(HtmlTextWriter)	Отрисовывает все содержимое элемента управления зоны между начальным и конечным тегами для указанного объекта HtmlTextWriter. (Унаследовано от WebZone)
RenderControl(HtmlTextWriter)	Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control)
RenderEndTag(HtmlTextWriter)	Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl)
RenderFooter(HtmlTextWriter)	Отрисовывает нижний колонтитул для зоны CatalogZoneBase. (Унаследовано от CatalogZoneBase)
RenderHeader(HtmlTextWriter)	Переопределяет базовый метод, чтобы выполнить специальные операции отрисовки для области верхнего колонтитула, необходимые для элементов управления ToolZone. (Унаследовано от ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Отображает отдельную команду в элементе управления ToolZone. (Унаследовано от ToolZone)
RenderVerbs(HtmlTextWriter)	Отрисовывает команды в области нижнего колонтитула зоны CatalogZoneBase. (Унаследовано от CatalogZoneBase)
ResolveAdapter()	Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control)
SaveControlState()	Сохраняет изменения в состоянии элемента управления CatalogZoneBase, которые произошли после обратного запроса веб-страницы на сервер. (Унаследовано от CatalogZoneBase)
SaveViewState()	Сохраняет изменения состояния просмотра, произошедшие с момента отправки страницы обратно на сервер. (Унаследовано от CatalogZoneBase)
SetDesignModeState(IDictionary)	Задает данные времени разработки для элемента управления. (Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)	Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control)
SetTraceData(Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(Object, Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Отслеживает изменения состояния просмотра элемента управления зоны. (Унаследовано от CatalogZoneBase)

События

DataBinding	Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control)
Disposed	Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control)
Init	Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control)
Load	Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control)
PreRender	Происходит после загрузки объекта Control, но перед отрисовкой. (Унаследовано от Control)
Unload	Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control)

Явные реализации интерфейса

IAttributeAccessor.GetAttribute(String)	Возвращает атрибуту веб-элемента управления указанное имя. (Унаследовано от WebControl)
IAttributeAccessor.SetAttribute(String, String)	Задает атрибуту веб-элемента управления указанное имя и значение. (Унаследовано от WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Позволяет дизайнеру воссоздавать коллекцию дочерних элементов составного элемента управления в среде разработки. (Унаследовано от CompositeControl)
IControlBuilderAccessor.ControlBuilder	Описание этого члена см. в разделе ControlBuilder. (Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()	Описание этого члена см. в разделе GetDesignModeState(). (Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Описание этого члена см. в разделе SetDesignModeState(IDictionary). (Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Описание этого члена см. в разделе SetOwnerControl(Control). (Унаследовано от Control)
IControlDesignerAccessor.UserData	Описание этого члена см. в разделе UserData. (Унаследовано от Control)
IDataBindingsAccessor.DataBindings	Описание этого члена см. в разделе DataBindings. (Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings	Описание этого члена см. в разделе HasDataBindings. (Унаследовано от Control)
IExpressionsAccessor.Expressions	Описание этого члена см. в разделе Expressions. (Унаследовано от Control)
IExpressionsAccessor.HasExpressions	Описание этого члена см. в разделе HasExpressions. (Унаследовано от Control)
IParserAccessor.AddParsedSubObject(Object)	Описание этого члена см. в разделе AddParsedSubObject(Object). (Унаследовано от Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Реализует метод LoadPostData(String, NameValueCollection) посредством вызова метода LoadPostData(String, NameValueCollection), принадлежащего классу CatalogZoneBase. (Унаследовано от CatalogZoneBase)
IPostBackDataHandler.RaisePostDataChangedEvent()	Описание этого члена см. в разделе RaisePostDataChangedEvent(). (Унаследовано от CatalogZoneBase)
IPostBackEventHandler.RaisePostBackEvent(String)	Реализует метод RaisePostBackEvent(String). (Унаследовано от ToolZone)

Методы расширения

FindDataSourceControl(Control)	Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.
FindFieldTemplate(Control, String)	Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.
FindMetaTable(Control)	Возвращает объект метатаблицы для контейнерного элемента управления данными.
GetDefaultValues(INamingContainer)	Получает коллекцию значений по умолчанию для заданного элемента управления данными.
GetMetaTable(INamingContainer)	Получает метаданные таблицы для заданного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable)	Задает метаданные таблицы для заданного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable, Object)	Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.
TryGetMetaTable(INamingContainer, MetaTable)	Определяет, доступны ли метаданные таблицы.
EnableDynamicData(INamingContainer, Type)	Включает поведение платформы динамических данных для указанного элемента управления данными.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Включает поведение платформы динамических данных для указанного элемента управления данными.
EnableDynamicData(INamingContainer, Type, Object)	Включает поведение платформы динамических данных для указанного элемента управления данными.

Применяется к

Поделиться через