CatalogZone CatalogZone CatalogZone CatalogZone Class

Определение

Служит основным элементом управления в наборе элементов управления веб-частей для размещения элементов управления CatalogPart на веб-странице.Serves as the primary control in the Web Parts control set for hosting CatalogPart controls on a Web page.

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
Наследование

Примеры

В следующем примере кода показано декларативное и программное использование CatalogZone элемента управления.The following code example demonstrates declarative and programmatic use of the CatalogZone control. Пример кода состоит из четырех частей:The code example has four parts:

  • Пользовательский элемент управления, позволяющий изменять режимы экрана на веб-странице.A user control that enables you to change display modes on the Web page.

  • Файл с исходным кодом для пользовательского CatalogZone элемента управления и пользовательский WebPart элемент управления, который импортируется по каталогу и добавляется на веб-страницу.A file with the source code for a custom CatalogZone control, and a custom WebPart control that is imported by the catalog and added to the Web page.

  • Веб-страница, объявляющая пользовательский элемент управления и пользовательский CatalogZone элемент управления.A Web page that declares the user control, and the custom CatalogZone control.

  • Пояснения к запуску примера.An explanation of how to run the example.

Первая часть этого примера кода — это пользовательский элемент управления, позволяющий пользователям изменять режимы экрана на веб-странице.The first part of this code example is the user control that enables users to change display modes on a Web page. Дополнительные сведения о режимах вывода и описание исходного кода в этом элементе управления см. в разделе Пошаговое руководство. Изменение режима экрана на веб-части странице.For details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ 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="&nbsp;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="&nbsp;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 элементов управления и. WebPartThe second part of the code example contains the code for the custom CatalogZone and WebPart controls. Код для CatalogZone элемента управления демонстрирует наследование CatalogZone от класса и настройку его свойств путем установки некоторых значений свойств по умолчанию в конструкторе.The code for the CatalogZone control demonstrates how to inherit from the CatalogZone class and customize its properties by setting some default property values in the constructor. Исходный код также демонстрирует создание пользовательского WebPart класса с именем. TextDisplayWebPartThe source code also demonstrates how to create a custom WebPart class named TextDisplayWebPart. Это элемент управления, связанный с. Файл описания WebPart, который будет импортирован как часть этого примера кода.This is the control associated with the .WebPart description file that you will import as part of this code example. После импорта файла описания с помощью ImportCatalogPart элемента управления на веб-странице вы сможете TextDisplayWebPart добавить элемент управления на страницу, предварительно настроенный в файле описания.After you import the description file by using the ImportCatalogPart control on the Web page, you'll be able to add the TextDisplayWebPart control to the page, fully pre-configured as specified in the description file.

Для выполнения примера кода необходимо скомпилировать этот исходный код.For the code example to run, you must compile this source code. Его можно скомпилировать явным образом и разместить полученную сборку в папке Bin веб-сайта или в глобальном кэше сборок.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Кроме того, можно разместить исходный код в папке App_Code сайта, где он будет динамически компилироваться во время выполнения.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. В этом примере кода используется динамическая компиляция, поэтому если вы хотите выполнить этот пример таким образом, присвойте файлу исходного кода имя и добавьте его во вложенную папку App_Code корневого каталога веб-приложения.This code example uses dynamic compilation, so if you want to run the example this way, name the source code file and add it to an App_Code subfolder of your Web application's root directory. Пошаговое руководство, в котором демонстрируются оба метода компиляции , см. в разделе Пошаговое руководство. Разработка и использование пользовательского серверного веб-элемента управления.For a walkthrough that demonstrates both methods of compiling, see Walkthrough: Developing and Using a Custom Web Server Control.

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

Третья часть примера кода — это веб-страница, содержащая элементы управления.The third part of the code example is the Web page that contains the controls. Он содержит Register директиву для пользовательского элемента управления, а другой — для исходного файла с пользовательскими элементами управления.It contains a Register directive for the user control, and another for the source file with the custom controls. Обратите внимание, что во второй директиве она не применяет имя сборки, так как в примере не используется сборка, она использует динамическую компиляцию с исходным кодом, помещенным во вложенную папку App_Code.Note that in the second directive, it does not name the assembly, because the example does not use an assembly, it uses dynamic compilation with the source code placed in the App_Code subfolder. Веб-страница объявляет WebPartZone элемент управления и в его дочернем <zonetemplate> элементе объявляет BulletedList элемент управления.The Web page declares a WebPartZone control, and within its child <zonetemplate> element, it declares a BulletedList control. Хотя это стандартный элемент управления ASP.NET, он будет иметь полную веб-частиную функциональность во время выполнения, поскольку WebPartManager элемент управления заключает в оболочку любой серверный элемент управления, помещенный WebPartZone в GenericWebPart объект, чтобы другие серверные элементы управления могли участвовать в Интернете. Части приложений.While this is a standard ASP.NET control, it will have full Web Parts functionality at run time, because the WebPartManager control wraps any server control placed in a WebPartZone with a GenericWebPart object, so that other server controls can participate in Web Parts applications. Кроме того, в этой зоне объявлен пользовательский WebPart элемент управления TextDisplayWebPartс именем.Also declared in this zone is the custom WebPart control named TextDisplayWebPart. Обратите внимание, что этот элемент управления ExportMode="All" имеет атрибут, объявленный для него.Notice that this control has an attribute of ExportMode="All" declared on it. Это позволяет экспортировать. Файл описания WebPart, содержащий значения свойств элемента управления, которые могут быть импортированы другими пользователями для добавления предварительно настроенного элемента управления на другие веб-страницы.This enables you to export a .WebPart description file that contains the property values of the control, which can be imported by other users to add the pre-configured control to other Web pages.

Примечание

Чтобы пользователи веб-частиного приложения могли экспортировать файл описания для WebPart элементов управления, необходимо также включить функцию экспорта в веб-приложении, enableExport="true" добавив атрибут к <webParts> элементу (который является дочерним <system.web>элементомэлементаэлемент) в файле Web. config.To enable users of a Web Parts application to export a description file for WebPart controls, you must also enable the export feature in the Web application by adding an enableExport="true" attribute to the <webParts> element (which is a child of the <system.web> element) in the Web.config file. Экспорт по умолчанию отключен, поэтому если вы еще не включили экспорт для своего приложения, измените файл Web. config и выполните его сейчас.Export is disabled by default, so if you not yet enabled export for your application, edit the Web.config file and do it now.

На веб-странице также объявляется пользовательский CatalogZone элемент управления и, внутри него <zonetemplate> , элемент, содержащий ImportCatalogPart элемент управления.The Web page also declares the custom CatalogZone control and, within it, a <zonetemplate> element that contains an ImportCatalogPart control. Пользователь будет использовать этот элемент управления во время выполнения для импорта. Файл описания веб-части для WebPart пользовательского элемента управления.The user will use this control at run time to import the .WebPart description file for the custom WebPart control.

<%@ 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>

Теперь запустите пример кода.Now run the code example. Загрузите веб-страницу в браузере.Load the Web page in a browser. Первым шагом является экспорт. Файл описания веб-части TextDisplayWebPart для элемента управления.The first step is to export a .WebPart description file for the TextDisplayWebPart control. Щелкните меню команд в пользовательском элементе управления (представленной стрелкой вниз в заголовке окна) и нажмите кнопку Экспорт.Click the verbs menu on the custom control (represented by the downward arrow in the title bar), and click Export. Следуйте инструкциям, чтобы сохранить файл описания для элемента управления.Follow the instructions to save a description file for the control. Откройте. Файл описания WebPart в редакторе и изменить значение текста свойства Title.Open the .WebPart description file in an editor, and edit the value of the title property text. Найдите элемент с атрибутом name="Title"и измените текст заголовка, содержащийся между открывающим и закрывающим <property> тегами. <property>Find the <property> element that has the attribute name="Title", and edit the title text that is contained between the opening and closing <property> tags. Теперь закройте веб-страницу и измените источник страницы в редакторе.Now close the Web page, and edit the page source in an editor. Удалите элемент объявления элемента управления, а затем сохраните и закройте файл. <aspSample:TextDisplayWebPart>Delete the <aspSample:TextDisplayWebPart> control declaration element, then save and close the file.

Снова загрузите веб-страницу в браузере.Load the Web page again in a browser. TextDisplayWebPart Элемент управления не должен отображаться, так как он был удален.The TextDisplayWebPart control should not appear, because you removed it. Используйте раскрывающийся список режим экрана и выберите Каталог , чтобы переключить страницу в режим каталога.Use the Display Mode drop-down list control and select Catalog to switch the page to catalog mode. Обратите внимание, CatalogZone что отображается пользовательский элемент управления вместе ImportCatalogPart с элементом управления.Notice that the custom CatalogZone control appears, along with the ImportCatalogPart control. Нажмите кнопку Обзор , чтобы найти. Файл описания веб-части, экспортированный TextDisplayWebPart для элемента управления.Click the Browse button to locate the .WebPart description file that you exported for the TextDisplayWebPart control. Можно нажать кнопку Отправить, установить флажок рядом с импортированным элементом управления и нажать кнопку Добавить , чтобы добавить его на страницу.You can click Upload, select the check box next to the imported control, and click Add to add it to the page. Нажмите кнопку Закрыть каталог , чтобы вернуть страницу в нормальный режим просмотра.Click Close Catalog to return the page to normal browse mode. Импортированный элемент управления должен отобразиться на странице, а заголовок, отображаемый в заголовке окна элемента управления, должен быть текстом заголовка, добавленным в. Файл описания веб-части.The imported control should now appear in the page, and the title that appears in the title bar of the control should be the title text you added to the .WebPart description file.

Комментарии

В наборе элементов управления веб-части зона — это область на веб-странице, которая содержит элементы управления веб-части.Within the Web Parts control set, a zone is a region on a Web page that contains Web Parts controls. Зона веб-части создается элементом управления зоны, который является типом CompositeControl , предназначенным для хранения других элементов управления.A Web Parts zone is created by a zone control, which is a type of CompositeControl designed to contain other controls. Основными функциями зоны являются размещение элементов управления, которые она содержит, и предоставление общего пользовательского интерфейса для этих элементов управления.The primary functions of a zone are to lay out the controls it contains, and to provide a common user interface (UI) for those controls. Общие сведения о зонах и их использовании в веб-части приложениях см. в разделе Базовый WebZone класс и Общие сведения о наборе элементов управления веб-части.For general information about zones and how they are used in Web Parts applications, see the base WebZone class, and Web Parts Control Set Overview.

Ключевой особенностью элементов управления веб-части является то, что они позволяют конечным пользователям изменять (или персонализировать) веб-страницы в соответствии с их предпочтениями и сохранять персонализированные параметры для будущих сеансов браузера.A key feature of Web Parts controls is that they allow end users to modify (or personalize) Web pages according to their preferences, and save their personalized settings for future browser sessions. Одним из аспектов изменения веб-части страниц является возможность добавлять WebPart элементы управления или другие серверные элементы управления на страницу веб-части.One aspect of modifying Web Parts pages includes the ability to add WebPart controls or other server controls to a Web Parts page. CatalogZone Элемент управления предоставляет список или каталог элементов управления, которые пользователи могут добавлять на страницу.The CatalogZone control provides a list or catalog of controls that users can add to a page.

CatalogZone Элемент управления является одним из основных элементов управления в наборе элементов управления веб-части.The CatalogZone control is one of the fundamental controls in the Web Parts control set. Он является производным от CatalogZoneBase класса, и большая часть его поведения наследуется от этого класса.It derives from the CatalogZoneBase class, and most of its behavior is inherited from that class. Класс CatalogZone , по сути, добавляет в базовый класс шаблон зоны, который является реализацией ITemplate интерфейса.The CatalogZone class essentially adds to the base class a zone template, which is an implementation of the ITemplate interface. Шаблон зоны позволяет разработчикам декларативно добавлять CatalogPart элементы управления в зону в формате сохранения страницы.The zone template enables developers to declaratively add CatalogPart controls to a zone in the page persistence format.

Важно!

CatalogPart CatalogPart CatalogZoneBase Зона может содержать только элементы управления, и наоборот, элементы управления могут находиться только в зонах, CatalogZoneпроизводных от класса, например. CatalogZoneA CatalogZone zone can contain only CatalogPart controls, and conversely, CatalogPart controls can reside only in zones that derive from the CatalogZoneBase class, such as CatalogZone.

Элемент управления отображается только в том случае, если пользователь переключает веб-страницу в режим отображенияCatalogDisplayModeкаталога (). CatalogZoneA CatalogZone control becomes visible only when a user switches a Web page to catalog display mode (CatalogDisplayMode). Каталог может содержать несколько типов CatalogPart элементов управления.A catalog can contain several types of CatalogPart controls. Каждый CatalogPart элемент управления — это тип контейнера, который содержит элементы управления сервера, которые пользователи могут добавлять на страницу.Each CatalogPart control is a type of container that contains the server controls users can add to the page. CatalogPart Элементы управления отличаются в зависимости от того, откуда поступают серверные элементы управления, которые они содержат.The CatalogPart controls differ according to where the server controls they contain are coming from. В следующей таблице перечислены CatalogPart элементы управления, предоставляемые набором элементов управления веб-части, а также типы элементов управления сервера, которые он содержит.The following table summarizes the CatalogPart controls provided with the Web Parts control set and, for each control, what kind of server controls it contains.

Элемент управленияControl ОписаниеDescription
PageCatalogPart Хранит ссылки на элементы управления, закрытые на странице.Maintains references to controls that have been closed on a page. Эти элементы управления можно повторно открыть (добавить обратно на страницу) пользователями.These controls can be reopened (added back to the page) by users.
DeclarativeCatalogPart Содержит ссылки на элементы управления, которые объявляются в веб-частином каталоге в разметке веб-страницы.Contains references to controls that are declared in a Web Parts catalog in the markup of a Web page. Пользователи могут добавлять эти элементы управления на веб-страницу.These controls can be added to a Web page by users.
ImportCatalogPart Предоставляет пользовательский интерфейс для отправки файла определения (XML-файл с расширением. Расширение WebPart и заданный формат, который содержит сведения о состоянии для элемента управления в каталоге, чтобы элемент управления можно было добавить на веб-страницу.Provides the UI for a user to upload a definition file (an XML file with a .WebPart extension and a specified format that contains state information) for a control to a catalog, so that the control can be added to a Web page.

CatalogZone Поскольку класс добавляет только шаблон зоны к поведению своего базового класса, он имеет несколько элементов.Because the CatalogZone class adds only a zone template to the behavior of its base class, it has few members. Конструктор является конструктором без параметров. с его помощью можно инициализировать новый экземпляр CatalogZone класса. CatalogZoneThe CatalogZone constructor is a parameterless constructor; with it, you can initialize a new instance of the CatalogZone class. Свойство получает или задает ссылку ITemplate на объект, содержащий элементы управления для зоны. ZoneTemplateThe ZoneTemplate property gets or sets a reference to the ITemplate object that contains the controls for the zone. CreateCatalogParts Метод является критически важным.The CreateCatalogParts method is critical. Он переопределяет базовый метод для создания коллекции всех CatalogPart элементов управления, содержащихся в шаблоне зоны.It overrides the base method to create the collection of all CatalogPart controls contained within the zone template.

Примечание

Для правильной работы кнопок CatalogZone в пользовательском интерфейсе требуются сценарии на стороне клиента.The buttons in the CatalogZone UI require client-side scripting in order to work correctly. Если в браузере отключено создание скриптов, пользователь не сможет выполнять действия через CatalogZone пользовательский интерфейс.If scripting is disabled in the browser, the user will not be able to perform actions through the CatalogZone UI.

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

Разметка, отображаемая по умолчанию для этого элемента управления, может не соответствовать стандартам специальных возможностей, таким как рекомендации по обеспечению доступности веб-содержимого 1,0 (WCAG) с приоритетом 1.The markup rendered by default for this control might not conform to accessibility standards such as the Web Content Accessibility Guidelines 1.0 (WCAG) priority 1 guidelines. Дополнительные сведения о поддержке специальных возможностей для этого элемента управления см. в разделе ASP.NET Controls and Accessibility.For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

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

Можно создавать пользовательские CatalogZone классы, если требуется больший контроль над отрисовкой и поведением пользовательского интерфейса каталога.You can create custom CatalogZone classes if you want more control over the rendering and behavior of the catalog UI. Если не требуется предоставлять пользователям элемента управления возможность декларативного добавления CatalogPart элементов управления, можно напрямую наследовать CatalogZoneBase от класса.If you do not need to provide users of your control with the ability to add CatalogPart controls declaratively, then you can inherit directly from the CatalogZoneBase class. Если требуется, чтобы элементы управления добавлялись декларативно, простой подход заключается в наследовании от CatalogZone класса, так как он предоставляет шаблон основной зоны.If you do want to enable controls to be added declaratively, the simples approach is to inherit from the CatalogZone class, because it provides the essential zone template.

CatalogZone При наследовании от класса можно CatalogPart CreateCatalogParts() переопределить метод и использовать метод для CatalogPartCollectionдобавления пользовательских элементов управления в, если требуется более программное управление добавлением пользовательских CatalogPart элементов управления в зону. .If you inherit from the CatalogZone class, you can override the CreateCatalogParts() method and use the method to add custom CatalogPart controls to a CatalogPartCollection, if you want greater programmatic control over adding custom CatalogPart controls to your zone.

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

CatalogZone() CatalogZone() CatalogZone() CatalogZone()

Инициализирует новый экземпляр класса CatalogZone.Initializes a new instance of the CatalogZone class.

Свойства

AccessKey AccessKey AccessKey AccessKey

Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Inherited from WebControl)
Adapter Adapter Adapter Adapter

Возвращает конкретный адаптер браузера для элемента управления.Gets the browser-specific adapter for the control.

(Inherited from Control)
AddVerb AddVerb AddVerb AddVerb

Получает ссылку на объект WebPartVerb, который позволяет конечным пользователям добавлять элементы управления из каталога на страницу веб-частей.Gets a reference to a WebPartVerb object that enables end users to add controls from a catalog to a Web Parts page.

(Inherited from CatalogZoneBase)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
AssociatedDisplayModes AssociatedDisplayModes AssociatedDisplayModes AssociatedDisplayModes

Получает коллекцию объектов WebPartDisplayMode, которые сопоставлены с некоторой зоной ToolZone.Gets the collection of WebPartDisplayMode objects that are associated with a particular ToolZone zone.

(Inherited from ToolZone)
Attributes Attributes Attributes Attributes

Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Inherited from WebControl)
BackColor BackColor BackColor BackColor

Получает или задает цвет фона серверного веб-элемента управления.Gets or sets the background color of the Web server control.

(Inherited from WebControl)
BackImageUrl BackImageUrl BackImageUrl BackImageUrl

Получает или задает URL-адрес фонового изображения для зоны.Gets or sets the URL to a background image for a zone.

(Inherited from WebZone)
BindingContainer BindingContainer BindingContainer BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.Gets the control that contains this control's data binding.

(Inherited from Control)
BorderColor BorderColor BorderColor BorderColor

Возвращает или задает цвет рамки элемента управления Веба.Gets or sets the border color of the Web control.

(Inherited from WebControl)
BorderStyle BorderStyle BorderStyle BorderStyle

Получает или задает стиль границы серверного веб-элемента управления.Gets or sets the border style of the Web server control.

(Inherited from WebControl)
BorderWidth BorderWidth BorderWidth BorderWidth

Возвращает или задает ширину границы серверного веб-элемента управления.Gets or sets the border width of the Web server control.

(Inherited from WebControl)
CatalogPartChrome CatalogPartChrome CatalogPartChrome CatalogPartChrome

Получает ссылку на экземпляр класса CatalogPartChrome, который сопоставлен с зоной CatalogZoneBase.Gets a reference to the instance of the CatalogPartChrome class associated with the CatalogZoneBase zone.

(Inherited from CatalogZoneBase)
CatalogParts CatalogParts CatalogParts CatalogParts

Получает коллекцию всех элементов управления CatalogPart, содержащихся в зоне CatalogZoneBase.Gets a collection of all the CatalogPart controls contained in a CatalogZoneBase zone.

(Inherited from CatalogZoneBase)
ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Возвращает значение символа разделителя, используемого в свойстве ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
CloseVerb CloseVerb CloseVerb CloseVerb

Возвращает ссылку на объект WebPartVerb, который позволяет конечным пользователям закрывать пользовательский интерфейс каталога и переключать страницу в обычный режим отображения.Gets a reference to a WebPartVerb object that enables end users to close the catalog user interface (UI) and return the page to normal browse mode.

(Inherited from CatalogZoneBase)
Context Context Context Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Возвращает объект ControlCollection, содержащий дочерние элементы CompositeControl.Gets a ControlCollection object that represents the child controls in a CompositeControl.

(Inherited from CompositeControl)
ControlStyle ControlStyle ControlStyle ControlStyle

Возвращает или задает стиль серверного веб-элемента управления.Gets the style of the Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Inherited from WebControl)
ControlStyleCreated ControlStyleCreated ControlStyleCreated ControlStyleCreated

Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Этот свойство в основном используется разработчиками элементов управления.This property is primarily used by control developers.

(Inherited from WebControl)
CssClass CssClass CssClass CssClass

Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Inherited from WebControl)
DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
Display Display Display Display

Получает значение, указывающее, отображается ли элемент управления ToolZone в данный момент.Gets a value that indicates whether a ToolZone control is currently displayed.

(Inherited from ToolZone)
EditUIStyle EditUIStyle EditUIStyle EditUIStyle

Получает атрибуты стиля для редактируемых элементов управления, содержащихся в элементе управления ToolZone.Gets the style attributes for the editable controls contained in a ToolZone control.

(Inherited from ToolZone)
EmptyZoneText EmptyZoneText EmptyZoneText EmptyZoneText

Получает или задает сообщение, которое отображается, если в зоне не содержится элементов управления.Gets or sets a message that appears when a zone contains no controls.

(Inherited from CatalogZoneBase)
EmptyZoneTextStyle EmptyZoneTextStyle EmptyZoneTextStyle EmptyZoneTextStyle

Получает атрибуты стиля для текста местозаполнителя в пустой зоне.Gets the style attributes for the placeholder text in an empty zone.

(Inherited from WebZone)
Enabled Enabled Enabled Enabled

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.Gets or sets a value indicating whether the Web server control is enabled.

(Inherited from WebControl)
EnableTheming EnableTheming EnableTheming EnableTheming

Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.Gets or sets a value indicating whether themes apply to this control.

(Inherited from WebControl)
EnableViewState EnableViewState EnableViewState EnableViewState

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
ErrorStyle ErrorStyle ErrorStyle ErrorStyle

Получает атрибуты стиля для отрисовки сообщения об ошибке, которое отображается, если элемент управления WebPart не может быть загружен или создан.Gets the style attributes for rendering the error message that is displayed if a WebPart control cannot be loaded or created.

(Inherited from WebZone)
Events Events Events Events

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

(Inherited from Control)
Font Font Font Font

Возвращает свойства шрифта, связанные с серверным веб-элементом управления.Gets the font properties associated with the Web server control.

(Inherited from WebControl)
FooterStyle FooterStyle FooterStyle FooterStyle

Получает атрибуты стиля для содержимого области нижнего колонтитула зоны.Gets the style attributes for the contents of a zone's footer area.

(Inherited from WebZone)
ForeColor ForeColor ForeColor ForeColor

Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Inherited from WebControl)
HasAttributes HasAttributes HasAttributes HasAttributes

Получает значение, определяющие наличие атрибутов у элемента управления.Gets a value indicating whether the control has attributes set.

(Inherited from WebControl)
HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
HasFooter HasFooter HasFooter HasFooter

Получает значение, указывающее, содержится ли в зоне область нижнего колонтитула.Gets a value indicating whether a zone has a footer area.

(Inherited from WebZone)
HasHeader HasHeader HasHeader HasHeader

Получает значение, указывающее, содержит ли зона область заголовка.Gets a value indicating whether a zone has a header area.

(Inherited from WebZone)
HeaderCloseVerb HeaderCloseVerb HeaderCloseVerb HeaderCloseVerb

Получает ссылку на объект WebPartVerb в верхнем колонтитуле зоны ToolZone, который используется для закрытия элемента управления.Gets a reference to the WebPartVerb object in the header of a ToolZone control that is used to close the control.

(Inherited from ToolZone)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Получает атрибуты стиля для содержимого области заголовка зоны.Gets the style attributes for the contents of a zone's header area.

(Inherited from WebZone)
HeaderText HeaderText HeaderText HeaderText

Получает или задает текст для области заголовка зоны.Gets or sets the text for the header area of a zone.

(Inherited from CatalogZoneBase)
HeaderVerbStyle HeaderVerbStyle HeaderVerbStyle HeaderVerbStyle

Получает атрибуты стиля для всех команд верхнего колонтитула, отображаемых в элементе управления ToolZone.Gets the style attributes for all header verbs displayed in a ToolZone control.

(Inherited from ToolZone)
Height Height Height Height

Получает или задает высоту серверного веб-элемента управления.Gets or sets the height of the Web server control.

(Inherited from WebControl)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

Описание этого члена см. в разделе UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
InstructionText InstructionText InstructionText InstructionText

Получает или задает текст в зоне, содержащий указания для пользователей.Gets or sets the text in a zone that provides directions for end users.

(Inherited from CatalogZoneBase)
InstructionTextStyle InstructionTextStyle InstructionTextStyle InstructionTextStyle

Получает атрибуты стиля для текста инструкций, выводящегося в верхней части элемента управления ToolZone.Gets the style attributes for the instruction text that appears at the top of a ToolZone control.

(Inherited from ToolZone)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsEnabled IsEnabled IsEnabled IsEnabled

Возвращает значение, определяющее, включен ли элемент управления.Gets a value indicating whether the control is enabled.

(Inherited from WebControl)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LabelStyle LabelStyle LabelStyle LabelStyle

Получает атрибуты стиля для содержимого меток, выводимых рядом с элементами управления редактирования в элементе управления ToolZone.Gets the style attributes for the contents of the labels that appear alongside the editing controls within a ToolZone control. Производные элементы управления ToolZone, такие как CatalogZone и EditorZone, применяют стили к меткам.The derived ToolZone controls, such as CatalogZone and EditorZone, apply the styles to the labels.

(Inherited from ToolZone)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
NamingContainer NamingContainer NamingContainer NamingContainer

Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Padding Padding Padding Padding

Получает или задает атрибуты поля ячейки в таблице зоны, содержащей элементы управления WebPart.Gets or sets the cell padding attributes on the table that contains the WebPart controls in a zone.

(Inherited from WebZone)
Page Page Page Page

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
PartChromePadding PartChromePadding PartChromePadding PartChromePadding

Получает или задает расстояние между содержимым элемента управления WebPart и границей элемента управления.Gets or sets the distance between the contents of a WebPart control and the border of the control.

(Inherited from WebZone)
PartChromeStyle PartChromeStyle PartChromeStyle PartChromeStyle

Получает характеристики стиля, применяемые к границам элементов управления веб-частей, содержащихся в зоне.Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

(Inherited from WebZone)
PartChromeType PartChromeType PartChromeType PartChromeType

Получает или задает тип границы, которая обрамляет элементы управления веб-частей, содержащихся в зоне.Gets or sets the type of border that frames Web Parts controls contained by a zone.

(Inherited from WebZone)
PartLinkStyle PartLinkStyle PartLinkStyle PartLinkStyle

Получает объект, содержащий атрибуты стиля для элементов управления CatalogPart, которые в настоящее время выбраны на странице.Gets an object that contains style attributes for the CatalogPart controls that are not currently selected in the zone.

(Inherited from CatalogZoneBase)
PartStyle PartStyle PartStyle PartStyle

Получает характеристики стиля, которые применяются к границе и содержимому каждого элемента управления веб-частей, содержащегося в зоне.Gets style characteristics that apply to the border and contents of each Web Parts control contained by a zone.

(Inherited from WebZone)
PartTitleStyle PartTitleStyle PartTitleStyle PartTitleStyle

Поучает атрибуты стиля для содержимого заголовка окна каждого элемента управления, содержащегося в зоне.Gets style attributes for the title bar content for each Web Parts control contained by a zone.

(Inherited from WebZone)
RenderClientScript RenderClientScript RenderClientScript RenderClientScript

Получает значение, которое указывает, следует ли отрисовывать клиентский скрипт на веб-странице.Gets a value that indicates whether to render client script on a Web Parts page.

(Inherited from WebZone)
RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
SelectedCatalogPartID SelectedCatalogPartID SelectedCatalogPartID SelectedCatalogPartID

Получает или задает строку в качестве идентификатора текущего выбранного элемента управления CatalogPart в зоне.Gets or sets a string as an identifier for the currently selected CatalogPart control in a zone.

(Inherited from CatalogZoneBase)
SelectedPartLinkStyle SelectedPartLinkStyle SelectedPartLinkStyle SelectedPartLinkStyle

Получает объект, который содержит атрибуты стиля для выбранного в настоящий момент элемента управления CatalogPart в зоне.Gets an object that contains style attributes for the CatalogPart control that is currently selected in the zone.

(Inherited from CatalogZoneBase)
SelectTargetZoneText SelectTargetZoneText SelectTargetZoneText SelectTargetZoneText

Получает или задает текст для элемента управления в пользовательском интерфейсе каталога, с помощью которого пользователи могут выбрать, в какую зону можно добавить выбранные элементы управления.Gets or sets the text alongside the control in the catalog user interface (UI) that allows users to choose which zone to add their selected controls to.

(Inherited from CatalogZoneBase)
ShowCatalogIcons ShowCatalogIcons ShowCatalogIcons ShowCatalogIcons

Получает или задает значение, указывающее, отображаются ли значки для серверных элементов управления в каталоге.Gets or sets a value that indicates whether server controls in the catalog display their associated icons in the catalog.

(Inherited from CatalogZoneBase)
Site Site Site Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Возвращает или задает обложку, применяемую к элементу управления.Gets or sets the skin to apply to the control.

(Inherited from WebControl)
Style Style Style Style

Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Inherited from WebControl)
SupportsDisabledAttribute SupportsDisabledAttribute SupportsDisabledAttribute SupportsDisabledAttribute

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Inherited from CompositeControl)
TabIndex TabIndex TabIndex TabIndex

Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления.Gets or sets the tab index of the Web server control.

(Inherited from WebControl)
TagKey TagKey TagKey TagKey

Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Inherited from WebZone)
TagName TagName TagName TagName

Возвращает имя тега элемента управления.Gets the name of the control tag. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Inherited from WebControl)
TemplateControl TemplateControl TemplateControl TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
ToolTip ToolTip ToolTip ToolTip

Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Inherited from WebControl)
UniqueID UniqueID UniqueID UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
VerbButtonType VerbButtonType VerbButtonType VerbButtonType

Получает или задает тип кнопки, используемый для представления команд в зоне.Gets or sets what kind of button is used to represent verbs in a zone.

(Inherited from WebZone)
VerbStyle VerbStyle VerbStyle VerbStyle

Получает атрибуты стиля для команд пользовательского интерфейса, связанного с элементами управления веб-частей в зоне.Gets the style attributes for the user interface (UI) verbs associated with Web Parts controls in a zone.

(Inherited from WebZone)
ViewState ViewState ViewState ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Получает или задает значение, определяющее, выводится ли серверный элемент управления на странице в виде элемента пользовательского интерфейса.Gets or sets a value that indicates whether a server control is rendered as a user interface (UI) element on the page.

(Inherited from ToolZone)
WebPartManager WebPartManager WebPartManager WebPartManager

Получает ссылку на элемент управления WebPartManager, связанный с экземпляром элемента управления WebZone на странице веб-частей.Gets a reference to the WebPartManager control associated with a WebZone control instance on a Web Parts page.

(Inherited from WebZone)
Width Width Width Width

Получает или задает ширину серверного веб-элемента управления.Gets or sets the width of the Web server control.

(Inherited from WebControl)
ZoneTemplate ZoneTemplate ZoneTemplate ZoneTemplate

Получает или задает шаблон, в котором будут содержаться дочерние элементы управления для элемента управления CatalogZone в формате сохранения страницы.Gets or sets a template to contain child controls within a CatalogZone control in page persistence format.

Методы

AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter) AddAttributesToRender(HtmlTextWriter)

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Inherited from WebControl)
AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyle(Style) ApplyStyle(Style) ApplyStyle(Style) ApplyStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Inherited from WebControl)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

Запускает трассировку во время разработки данных отрисовки.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

Задает для кэшированного свойства ClientID значение null.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
Close() Close() Close() Close()

Переключает веб-страницу из режима отображения каталога в обычный режим просмотра.Switches the Web page from catalog display mode to normal browse mode.

(Inherited from CatalogZoneBase)
CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl) CopyBaseAttributes(WebControl)

Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Inherited from WebControl)
CreateCatalogPartChrome() CreateCatalogPartChrome() CreateCatalogPartChrome() CreateCatalogPartChrome()

Создает экземпляр объекта CatalogPartChrome, используемого для отрисовки периферийных элементов пользовательского интерфейса для элементов управления CatalogPart в зоне.Creates an instance of a CatalogPartChrome object used to render the peripheral user interface (UI) elements for CatalogPart controls in a zone.

(Inherited from CatalogZoneBase)
CreateCatalogParts() CreateCatalogParts() CreateCatalogParts() CreateCatalogParts()

Создает экземпляр каждого типа CatalogPart, объявленного в зоне.Creates an instance of each CatalogPart type that is declared in the zone.

CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Создает набор дочерних элементов управления, сопоставленных с зоной CatalogZoneBase.Creates the set of child controls associated with a CatalogZoneBase zone.

(Inherited from CatalogZoneBase)
CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Inherited from Control)
CreateControlStyle() CreateControlStyle() CreateControlStyle() CreateControlStyle()

Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств.Creates the style object that is used internally by the WebControl class to implement all style related properties. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Inherited from WebControl)
DataBind() DataBind() DataBind() DataBind()

Привязывает источник данных к CompositeControl и ко всем его дочерним элементам управления.Binds a data source to the CompositeControl and all its child controls.

(Inherited from CompositeControl)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

Привязывает источник данных к дочерним элементам управления серверного элемента управления.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose() Dispose() Dispose() Dispose()

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines whether the server control contains child controls. Если дочерних элементов управления нет, они будут созданы.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Эту версию метода FindControl не следует переопределять.You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Задает фокус ввода на элемент управления.Sets input focus to a control.

(Inherited from Control)
GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

Возвращает данные времени разработки для элемента управления.Gets design-time data for a control.

(Inherited from Control)
GetEffectiveChromeType(Part) GetEffectiveChromeType(Part) GetEffectiveChromeType(Part) GetEffectiveChromeType(Part)

Возвращает фактическое или эффективное текущее значение PartChromeType элемента управления WebPart, учитывая свойство зоны PartChromeType и текущий режим отображения страницы веб-частей.Returns the actual or effective current PartChromeType value of a WebPart control, given the PartChromeType property of the zone and the current display mode of the Web Parts page.

(Inherited from WebZone)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Возвращает часть с префиксом свойства UniqueID указанного элемента управления.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls() HasControls() HasControls() HasControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents() HasEvents() HasEvents() HasEvents()

Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
InvalidateCatalogParts() InvalidateCatalogParts() InvalidateCatalogParts() InvalidateCatalogParts()

Уничтожает коллекцию элементов управления CatalogPart, связанную с зоной CatalogZoneBase.Destroys the collection of CatalogPart controls associated with a CatalogZoneBase zone.

(Inherited from CatalogZoneBase)
IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

Определяет наличие у серверного элемента управления только текстового содержимого.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Загружает состояние из предыдущего запроса страницы для свойств элемента управления, которые должны быть постоянными в обратных запросах, даже если для элемента управления отключено состояние просмотра.Loads the state from a previous page request for control properties that should persist across postbacks even when view state is disabled on the control.

(Inherited from CatalogZoneBase)
LoadPostData(String, NameValueCollection) LoadPostData(String, NameValueCollection) LoadPostData(String, NameValueCollection) LoadPostData(String, NameValueCollection)

Обрабатывает состояние флажков, соответствующих элементам управления WebPart в каталоге, при обратном запросе страницы на сервер.Processes the state of the check boxes that correspond to the WebPart controls in the catalog, when the page is posted back to the server.

(Inherited from CatalogZoneBase)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Загружает ранее сохраненные сведения о состоянии для зоны.Loads previously saved state information for a zone.

(Inherited from CatalogZoneBase)
MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MergeStyle(Style) MergeStyle(Style) MergeStyle(Style) MergeStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Inherited from WebControl)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Создает событие DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать аспекты изменения режимов отображения страницы для специальной зоны.Provides a base method declaration that derived ToolZone controls can override to handle the details of changing page display modes for a specialized zone.

(Inherited from ToolZone)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Регистрирует объект страницы, чтобы страница нуждалась в состоянии элемента управления.Registers the page object so that the page requires control state.

(Inherited from CatalogZoneBase)
OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Создает событие Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Создает событие PreRender и регистрирует объект страницы, чтобы были необходимы обратные запросы.Raises the PreRender event and registers the page object so that it requires postbacks.

(Inherited from CatalogZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs) OnSelectedWebPartChanged(Object, WebPartEventArgs) OnSelectedWebPartChanged(Object, WebPartEventArgs) OnSelectedWebPartChanged(Object, WebPartEventArgs)

Содержит объявление базового метода, которое можно переопределить в производных элементах управления ToolZone, чтобы обрабатывать событие изменения элемента управления веб-частей, выбранного в специальной зоне.Provides a base method declaration that derived ToolZone controls can override to handle the event of changing which Web Parts control is selected within a specialized zone.

(Inherited from ToolZone)
OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Вызывает событие Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

Возвращает Stream, используемое для чтения файла.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RaisePostBackEvent(String) RaisePostBackEvent(String) RaisePostBackEvent(String) RaisePostBackEvent(String)

Выполняет действия, сопоставленные с одной из команд зоны, или вызывает событие, выполняющее обратную передачу на сервер.Carries out the actions associated with one of the zone verbs, or raises an event that posts back to the server.

(Inherited from CatalogZoneBase)
RecreateChildControls() RecreateChildControls() RecreateChildControls() RecreateChildControls()

Воссоздает дочерние элементы элемента управления, являющегося наследником CompositeControl.Recreates the child controls in a control derived from CompositeControl.

(Inherited from CompositeControl)
RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Отображает зону в указанном объекте HtmlTextWriter.Renders the zone to the specified HtmlTextWriter object.

(Inherited from CatalogZoneBase)
RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter) RenderBeginTag(HtmlTextWriter)

Отрисовывает HTML-тег открытия элемента управления зоны для указанного объекта HtmlTextWriter.Renders the opening HTML tag of the zone control to the specified HtmlTextWriter object.

(Inherited from WebZone)
RenderBody(HtmlTextWriter) RenderBody(HtmlTextWriter) RenderBody(HtmlTextWriter) RenderBody(HtmlTextWriter)

Переопределяет базовый метод, чтобы отобразить основную область зоны, производной от класса CatalogZoneBase.Overrides the base method to render the body area of a zone derived from the CatalogZoneBase class.

(Inherited from CatalogZoneBase)
RenderCatalogPartLinks(HtmlTextWriter) RenderCatalogPartLinks(HtmlTextWriter) RenderCatalogPartLinks(HtmlTextWriter) RenderCatalogPartLinks(HtmlTextWriter)

Отрисовывает ссылки на отдельные элементы управления CatalogPart в зоне CatalogZoneBase.Renders the links to the individual CatalogPart controls in a CatalogZoneBase zone.

(Inherited from CatalogZoneBase)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter) RenderContents(HtmlTextWriter)

Отрисовывает все содержимое элемента управления зоны между начальным и конечным тегами для указанного объекта HtmlTextWriter.Renders the entire contents of a zone control between the beginning and ending tags to the specified HtmlTextWriter object.

(Inherited from WebZone)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter) RenderEndTag(HtmlTextWriter)

Отображает закрывающий HTML-тег элемента управления в указанное средство записи.Renders the HTML closing tag of the control into the specified writer. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Inherited from WebControl)
RenderFooter(HtmlTextWriter) RenderFooter(HtmlTextWriter) RenderFooter(HtmlTextWriter) RenderFooter(HtmlTextWriter)

Отрисовывает нижний колонтитул для зоны CatalogZoneBase.Renders the footer area for a CatalogZoneBase zone.

(Inherited from CatalogZoneBase)
RenderHeader(HtmlTextWriter) RenderHeader(HtmlTextWriter) RenderHeader(HtmlTextWriter) RenderHeader(HtmlTextWriter)

Переопределяет базовый метод, чтобы выполнить специальные операции отрисовки для области верхнего колонтитула, необходимые для элементов управления ToolZone.Overrides the base method to provide specialized rendering for the header area required by ToolZone controls.

(Inherited from ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb) RenderVerb(HtmlTextWriter, WebPartVerb) RenderVerb(HtmlTextWriter, WebPartVerb) RenderVerb(HtmlTextWriter, WebPartVerb)

Отображает отдельную команду в элементе управления ToolZone.Renders an individual verb with a ToolZone control.

(Inherited from ToolZone)
RenderVerbs(HtmlTextWriter) RenderVerbs(HtmlTextWriter) RenderVerbs(HtmlTextWriter) RenderVerbs(HtmlTextWriter)

Отрисовывает команды в области нижнего колонтитула зоны CatalogZoneBase.Renders the verbs in the footer area of a CatalogZoneBase zone.

(Inherited from CatalogZoneBase)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() SaveControlState()

Сохраняет изменения в состоянии элемента управления CatalogZoneBase, которые произошли после обратного запроса веб-страницы на сервер.Saves any changes in a CatalogZoneBase control's state that occur after the Web page is posted back to the server.

(Inherited from CatalogZoneBase)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Сохраняет изменения состояния просмотра, произошедшие с момента отправки страницы обратно на сервер.Saves any view-state changes that have occurred after a page was posted back to the server.

(Inherited from CatalogZoneBase)
SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Задает данные времени разработки для элемента управления.Sets design-time data for a control.

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Отслеживает изменения в состоянии представления для элемента управления зоны.Tracks changes to a zone control's view state.

(Inherited from CatalogZoneBase)

События

DataBinding DataBinding DataBinding DataBinding

Происходит при привязке серверного элемента управления к источнику данных.Occurs when the server control binds to a data source.

(Inherited from Control)
Disposed Disposed Disposed Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init Init Init Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Происходит при загрузке серверного элемента управления в объект Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender PreRender PreRender PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Unload Unload Unload Unload

Происходит при выгрузке серверного элемента управления из памяти.Occurs when the server control is unloaded from memory.

(Inherited from Control)

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

IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String) IAttributeAccessor.GetAttribute(String)

Возвращает атрибуту веб-элемента управления указанное имя.Gets an attribute of the Web control with the specified name.

(Inherited from WebControl)
IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String) IAttributeAccessor.SetAttribute(String, String)

Задает атрибуту веб-элемента управления указанное имя и значение.Sets an attribute of the Web control to the specified name and value.

(Inherited from WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls() ICompositeControlDesignerAccessor.RecreateChildControls() ICompositeControlDesignerAccessor.RecreateChildControls() ICompositeControlDesignerAccessor.RecreateChildControls()

Позволяет дизайнеру воссоздавать коллекцию дочерних элементов составного элемента управления в среде разработки.Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(Inherited from CompositeControl)
IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

Описание этого члена см. в разделе SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection) IPostBackDataHandler.LoadPostData(String, NameValueCollection) IPostBackDataHandler.LoadPostData(String, NameValueCollection) IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Реализует метод LoadPostData(String, NameValueCollection) посредством вызова метода LoadPostData(String, NameValueCollection), принадлежащего классу CatalogZoneBase.Implements the LoadPostData(String, NameValueCollection) method by calling the LoadPostData(String, NameValueCollection) method of the CatalogZoneBase class.

(Inherited from CatalogZoneBase)
IPostBackDataHandler.RaisePostDataChangedEvent() IPostBackDataHandler.RaisePostDataChangedEvent() IPostBackDataHandler.RaisePostDataChangedEvent() IPostBackDataHandler.RaisePostDataChangedEvent()

Описание этого члена см. в разделе RaisePostDataChangedEvent().For a description of this member, see RaisePostDataChangedEvent().

(Inherited from CatalogZoneBase)
IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String) IPostBackEventHandler.RaisePostBackEvent(String)

Реализует метод RaisePostBackEvent(String).Implements the RaisePostBackEvent(String) method.

(Inherited from ToolZone)

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

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer)

Получает коллекцию значений по умолчанию для заданного элемента управления данными.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer)

Получает метаданные таблицы для заданного элемента управления данными.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable)

Задает метаданные таблицы для заданного элемента управления данными.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable)

Определяет, доступны ли метаданные таблицы.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

Безопасность

AspNetHostingPermission
для работы в размещенной на сервере среде.for operating in a hosted environment. Значение запроса: InheritanceDemand; значение разрешения: Minimal.Demand value: InheritanceDemand; Permission value: Minimal.

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

Дополнительно