WebZone Класс

Определение

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

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

Важно!

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

Служит базовым классом для всех элементов управления, которые являются контейнерами для элементов управления сервера (включая элементы управления веб-частей Part , серверные элементы управления и пользовательские элементы управления) в приложениях веб-частей.

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl

[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl

[<System.ComponentModel.Bindable(false)>]
type WebZone = class
    inherit CompositeControl

Public MustInherit Class WebZone
Inherits CompositeControl

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

Control

WebControl

CompositeControl
WebZone

Производный: System.Web.UI.WebControls.WebParts.ToolZone

System.Web.UI.WebControls.WebParts.WebPartZoneBase

Атрибуты: BindableAttribute

Примеры

В следующем примере кода показано использование WebZone класса.

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

using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class CalendarWebPart : WebPart
  {
    Calendar _calendar;

    public CalendarWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

    public LinksWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}

Imports System.Security.Permissions 
Imports System.Web
Imports System.Web.UI.WebControls 
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _ 
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
Public Class CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace

Во второй части примера кода показана веб-страница, на которую размещаются WebPart элементы управления. Обратите внимание, что декларативная разметка содержит два WebPartZone элемента управления, CatalogZone элемент управления и EditorZone элемент управления.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

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

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

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

Важной ролью зон веб-частей является включение полнофункциональных функций веб-частей для элементов управления, содержащихся в них. Каждая страница веб-частей содержит по крайней мере одну зону, а зона может содержать ноль или несколько элементов управления. Зоны необходимы для функциональных возможностей веб-частей. Без зон даже элементы управления, производные от WebPart класса, могут иметь очень мало функций веб-частей. И наоборот, из-за разработки набора элементов управления веб-частей вы можете поместить обычные ASP.NET элементы управления, серверные элементы управления или пользовательские элементы управления в WebPartZoneBase зону (которая является производным WebZoneот), и в силу того, что они находятся в зоне, эти обычные серверные элементы управления могут выступать в качестве WebPart элементов управления во время выполнения. Дополнительные сведения см. в документации для GenericWebPart класса.

Замечание

Можно добавить Part или WebPart элементы управления на страницу за пределами зоны, но в этом случае они просто работают как обычные серверные элементы управления.

Существует две широкие категории зон в наборе элементов управления веб-частей, все из которых наследуются от базового WebZone класса.

WebPartZoneBase Зоны. Они содержат WebPart элементы управления (и другие серверные и пользовательские) и формируют основной пользовательский интерфейс страниц веб-частей, с которыми пользователи взаимодействуют больше всего времени.
ToolZone Зоны. Эти зоны предоставляют специальные представления страницы веб-частей, которые позволяют пользователям изменять (персонализировать) содержимое, макет, внешний вид, поведение и свойства элементов управления, содержащихся в WebPartZoneBase зонах на странице веб-частей. Например, CatalogZoneBase зона — это ToolZone зона, которая предоставляет представление каталога страницы, позволяя пользователям добавлять и удалять серверные элементы управления. Зона EditorZoneBase — это другой тип ToolZone , который предоставляет представление редактирования страницы, позволяя пользователям изменять и изменять макет страницы, а также свойства, внешний вид и поведение элементов управления.

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

Тип элемента управления частью	Тип зоны
WebPart (и серверные и пользовательские элементы управления, которые упаковываются во GenericWebPart время выполнения)	WebPartZone (базовый класс — WebPartZoneBase )
EditorPart (некоторые производные элементы управления предоставляются набором элементов управления веб-частей, а пользовательские EditorPart элементы управления можно разрабатывать).	EditorZone (базовый класс — EditorZoneBase )
CatalogPart (некоторые производные элементы управления предоставляются набором элементов управления веб-частей, а пользовательские CatalogPart элементы управления можно разрабатывать).	CatalogZone (базовый класс — CatalogZoneBase )
WebPartConnection (элементы управления подключения уникальными в том, что они не являются элементами управления, наследуемыми от базового класса)	ConnectionsZone (наследуется непосредственно от ToolZone )

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

Раздел "Зона"	Описание
Header	Верхний раздел зоны. Он включает текст заголовка, который может включать заголовок для зоны; атрибуты стиля (например, граница или цвет фона), которые различают заголовок; и команды уровня зоны (представленные кнопками, гиперссылками или изображениями), которые пользователи могут щелкнуть, чтобы выполнить действия пользовательского интерфейса, которые применяются ко всей зоне, например закрытие зоны. Несколько WebZone свойств, таких как HeaderStyle HasHeader, и HeaderText, относятся к области заголовка зоны. Если в зоне есть команды уровня зоны, VerbButtonType к ним применяются свойства.VerbStyle Обратите внимание, что эти два свойства команды применяются только к командам уровня зоны, а не к командам в элементах управления отдельных частей, содержащихся в зоне. Заголовки не присутствуют в каждой зоне; Обычно они отображаются в ToolZone зонах, в которых требуется иметь общую область заголовка с текстом и командой, например закрываемой командой.
Тело	Основной раздел содержимого зоны. Каждая зона, наследуемая от WebZone основного раздела. Для всех типов зон в наборе элементов управления веб-частей текст зоны содержит указанный тип элементов управления (или другие серверные элементы управления), соответствующие типу Part зоны, как указано в предыдущей таблице. Различные члены WebZone класса влияют на содержимое раздела тела, например BackImageUrl, и PartChromeStyle PartChromeType PartStyle свойств. Если раздел текста пуст, EmptyZoneText сообщение может отображаться в определенных ситуациях.
Хром	Общие элементы пользовательского интерфейса, отображаемые для каждого элемента управления частью в зоне. Это отличается от обсуждения атрибутов стиля, которые применяются к самой зоне; chrome применяется специально к элементам управления автономной частью. Chrome включает команды, границы и другие атрибуты стиля, такие как цвет фона или стиль шрифта текста заголовка для элементов управления частью зоны. Зона определяет сведения о хромах с помощью одного объекта хрома, соответствующего типу элементов управления, который он содержит (например, CatalogPartChrome объект для CatalogZone элемента управления, содержащего CatalogPart элементы управления). Этот один объект хрома обрабатывает сведения о хромах и отрисовку для всех элементов управления частью в зоне. Это позволяет разработчикам создавать зоны, в которых они могут указать согласованный, общий внешний вид и ощущение для всех элементов управления частью. Некоторые свойства, относящиеся к хрома для элементов управления частью зоны, включают PartChromeStyle PartChromeTypeсвойства , PartStyleи PartTitleStyle свойства. Обратите внимание, что большинство свойств, связанных с хрома, включая определенное свойство для ссылки на объект chrome для определенного типа зоны, не реализуются в базовом WebZone классе. Вместо этого большинство функций зон, относящихся к хрому, реализуются в конкретных типах зон в соответствии с уникальными потребностями элементов управления их частью. См. разделы для каждого типа зоны, перечисленные в предыдущей таблице этой статьи.
Элементы управления частью	Элементы управления, находящиеся в разделе текста зоны. Каждая зона, наследуемая от WebZone класса, содержится в разделе тела одного или нескольких элементов управления соответствующего типа, как показано в предыдущей таблице в этом разделе. Эти элементы управления частью формируют основной пользовательский интерфейс приложений веб-частей. Большинство типов зон, производных от WebZone свойства коллекции, которые позволяют им ссылаться на все содержащиеся элементы управления частью, такие как свойство WebPartZoneBase класса, а EditorParts также WebParts свойство классаEditorZoneBase.
Нижний колонтитул	Нижний раздел зоны. Как и раздел заголовка, он не присутствует в каждом типе зоны, но обычно происходит в ToolZone зонах. Типичное содержимое раздела нижнего колонтитула — это команды, такие как ОК или применить глагол, которые отображаются в нижнем EditorZoneBase колонтитуле зон. Некоторые свойства, относящиеся к разделу нижнего колонтитула, включают HasFooter FooterStyleсвойства , VerbButtonTypeи VerbStyle свойства.

WebZone Большинство свойств класса рассматриваются в предыдущей таблице, описывающей общие элементы пользовательского интерфейса зон. Класс WebZone также имеет несколько методов, связанных с ролью содержимого отрисовки. RenderContentsМетоды RenderBody, RenderFooterи RenderHeader методы можно переопределить, чтобы обеспечить программный контроль над отрисовкой каждого конкретного раздела зоны. Например, если вы хотите настроить отрисовку всех разделов нижних колонтитулов зон каталога в приложении, вы можете наследовать от CatalogZoneBase класса, переопределить RenderFooter метод, унаследованный от WebZone, и изменить отрисовку нижнего колонтитула.

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

Для разработки пользовательских зон веб-частей редко требуется наследовать непосредственно от WebZone класса. Набор элементов управления веб-частей содержит специализированные зоны, перечисленные выше в разделе "Примечания", и, как правило, можно наследовать от одного из них, чтобы добавить настраиваемое поведение в зону. Если вы решите наследовать непосредственно от WebZone класса, необходимо переопределить ряд свойств и методов (см. документацию для членов WebZone класса). Кроме того, необходимо создать пользовательский WebPartManager элемент управления, при необходимости пользовательский WebPartDisplayMode элемент управления, чтобы создать уникальный режим отображения, в котором можно просмотреть зону и другие настройки, чтобы обеспечить работу зоны в наборе элементов управления веб-частей.

Свойства

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

Методы

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

События

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

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

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

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

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

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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