EditorZone Класс

Определение

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

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

Важно!

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

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

public ref class EditorZone : System::Web::UI::WebControls::WebParts::EditorZoneBase

public class EditorZone : System.Web.UI.WebControls.WebParts.EditorZoneBase

type EditorZone = class
    inherit EditorZoneBase

Public Class EditorZone
Inherits EditorZoneBase

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

Control

WebControl

CompositeControl

WebZone

ToolZone

EditorZoneBase
EditorZone

Примеры

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

Пример кода состоит из трех частей:

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

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

<%@ 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 + " Mode", modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

  }
 
  // 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;

  }

  void Page_PreRender(object sender, EventArgs e)
  {
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
  }
  
</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</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 + " Mode", modeName)
            DisplayModeDropdown.Items.Add(item)
        End If
    Next mode

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 


Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs) 
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name

End Sub 

</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>

Второй частью примера кода является веб-страница. В верхней части страницы находится Register директива для пользовательского элемента управления. Тег пользовательского элемента управления объявляется на странице с uc1: префиксом для элемента. Обратите внимание, что под <asp:WebPartZone> элементом <asp:EditorZone> является элемент, содержащий несколько EditorPart элементов управления, с некоторыми тегами и свойствами, заданными для определения его внешнего вида и поведения. Существует также ряд методов, которые обращаются к различным членам EditorZone элемента управления программным способом.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuCS" 
  src="displaymodecs.ascx" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  // <snippet3>

  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }

  void Button2_Click(object sender, EventArgs e)
  {
    EditorZone1.BorderWidth = 2;
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue;
  }

  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }

  void Button4_Click(object sender, EventArgs e)
  {
    EditorZone1.InstructionText = "My custom instruction text.";
  }
  // </snippet3>
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="mgr" runat="server" />
    <uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
    <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>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <asp:EditorZone ID="EditorZone1" runat="server" >
      <VerbStyle Font-Italic="true" />
      <EditUIStyle BackColor="lightgray" />
      <PartChromeStyle BorderWidth="1" />
      <LabelStyle Font-Bold="true" />
      <CancelVerb Text="Cancel Changes" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuVB" 
  src="displaymodevb.ascx" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  ' <snippet3>

  Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.ApplyVerb.Enabled = True Then
      EditorZone1.ApplyVerb.Enabled = False
    Else
      EditorZone1.ApplyVerb.Enabled = True
    End If
  End Sub
 
  Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.BorderWidth = 2
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue
  End Sub

  Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
    Label1.Text = "<br />"
    Dim part As EditorPart
    For Each part In EditorZone1.EditorParts
      Label1.Text += part.ID + "<br />"
    Next part
  End Sub

  Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.InstructionText = "My custom instruction text."
  End Sub
  ' </snippet3>
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="mgr" runat="server" />
    <uc1:DisplayModeMenuVB runat="server" id="displaymodemenu1" />
    <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>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <asp:EditorZone ID="EditorZone1" runat="server" >
      <VerbStyle Font-Italic="true" />
      <EditUIStyle BackColor="lightgray" />
      <PartChromeStyle BorderWidth="1" />
      <LabelStyle Font-Bold="true" />
      <CancelVerb Text="Cancel Changes" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

При загрузке страницы в браузере можно выбрать режим редактирования в раскрывающемся списке, чтобы переключиться на режим редактирования. Чтобы отобразить пользовательский интерфейс редактирования, щелкните меню команд (стрелка вниз) в строке заголовка одного из двух элементов управления и нажмите кнопку "Изменить ", чтобы изменить элемент управления. С видимым пользовательским интерфейсом редактирования можно увидеть эффекты декларативного и программного EditorZone использования членов класса.

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

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

Элемент EditorZone управления становится видимым при вводе страницы веб-частей в режим редактирования, и он делает доступными различные EditorPart элементы управления, которые можно использовать для персонализации WebPart элементов управления. Элемент управления очень похож на его родительский класс, EditorZoneBase с одним ключевым различием: EditorZone элемент EditorZone управления предоставляет шаблон зоны, на который ссылается его ZoneTemplate свойство. Шаблон зоны добавляет возможность объявления содержимого в формате сохраняемости страницы. Разработчики страницы могут поместить элемент управления в декларативную EditorZone разметку веб-страницы, добавить дочерний <zonetemplate> элемент и в <zonetemplate> элементе добавить декларативные ссылки на EditorPart элементы управления.

Элемент EditorZone управления также имеет метод, CreateEditorPartsкоторый переопределяет базовый метод в EditorZoneBase классе. Этот метод необходим, чтобы EditorZone элемент управления смог создать шаблон зоны, чтобы содержать все EditorPart элементы управления, добавляемые в зону декларативно.

Замечание

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

Доступность

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

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

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

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

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

Свойства

Имя	Описание
AccessKey	Возвращает или задает ключ доступа, позволяющий быстро перейти к элементу управления веб-сервера. (Унаследовано от WebControl)
Adapter	Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control)
ApplyVerb	Возвращает ссылку на WebPartVerb объект, который позволяет конечным пользователям применять изменения правки к элементу управления в режиме редактирования. (Унаследовано от EditorZoneBase)
AppRelativeTemplateSourceDirectory	Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control)
AssociatedDisplayModes	Возвращает коллекцию WebPartDisplayMode объектов, связанных с определенной ToolZone зоной. (Унаследовано от ToolZone)
Attributes	Возвращает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl)
BackColor	Возвращает или задает цвет фона элемента управления веб-сервера. (Унаследовано от WebControl)
BackImageUrl	Возвращает или задает URL-адрес фонового изображения для зоны. (Унаследовано от WebZone)
BindingContainer	Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control)
BorderColor	Возвращает или задает цвет границы веб-элемента управления. (Унаследовано от WebControl)
BorderStyle	Возвращает или задает стиль границы элемента управления веб-сервера. (Унаследовано от WebControl)
BorderWidth	Возвращает или задает ширину границы элемента управления веб-сервера. (Унаследовано от WebControl)
CancelVerb	Получает ссылку на WebPartVerb объект, позволяющий конечным пользователям отменять изменения в элементе управления в режиме редактирования. (Унаследовано от EditorZoneBase)
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)
Display	Возвращает значение, указывающее, отображается ли ToolZone элемент управления в данный момент. (Унаследовано от EditorZoneBase)
EditorPartChrome	Возвращает ссылку на экземпляр класса, связанного EditorPartChrome с EditorZoneBase зоной. (Унаследовано от EditorZoneBase)
EditorParts	Возвращает коллекцию всех элементов управления, EditorPart содержащихся в EditorZoneBase зоне. (Унаследовано от EditorZoneBase)
EditUIStyle	Возвращает атрибуты стиля для редактируемых элементов управления, содержащихся в элементе ToolZone управления. (Унаследовано от ToolZone)
EmptyZoneText	Возвращает или задает сообщение, которое отображается, когда зона не содержит элементов управления. (Унаследовано от EditorZoneBase)
EmptyZoneTextStyle	Возвращает атрибуты стиля для текста заполнителя в пустой зоне. (Унаследовано от WebZone)
Enabled	Возвращает или задает значение, указывающее, включен ли элемент управления веб-сервера. (Унаследовано от WebControl)
EnableTheming	Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl)
EnableViewState	Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control)
ErrorStyle	Возвращает атрибуты стиля для отрисовки сообщения об ошибке, отображаемого WebPart , если элемент управления не может быть загружен или создан. (Унаследовано от WebZone)
ErrorText	Возвращает или задает текст сообщения об ошибке уровня зоны, отображаемого в верхней части пользовательского интерфейса редактирования. (Унаследовано от EditorZoneBase)
Events	Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control)
Font	Возвращает свойства шрифта, связанные с элементом управления веб-сервера. (Унаследовано от WebControl)
FooterStyle	Возвращает атрибуты стиля для содержимого нижнего колонтитула зоны. (Унаследовано от WebZone)
ForeColor	Возвращает или задает цвет переднего плана (обычно цвет текста) элемента управления веб-сервера. (Унаследовано от WebControl)
HasAttributes	Возвращает значение, указывающее, имеет ли элемент управления набор атрибутов. (Унаследовано от WebControl)
HasChildViewState	Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control)
HasFooter	Возвращает значение, указывающее, имеет ли зона область нижнего колонтитула. (Унаследовано от WebZone)
HasHeader	Возвращает значение, указывающее, имеет ли зона область заголовка. (Унаследовано от WebZone)
HeaderCloseVerb	Получает ссылку на WebPartVerb объект в заголовке ToolZone элемента управления, который используется для закрытия элемента управления. (Унаследовано от ToolZone)
HeaderStyle	Возвращает атрибуты стиля для содержимого области заголовка зоны. (Унаследовано от WebZone)
HeaderText	Возвращает или задает текст для области заголовка зоны. (Унаследовано от EditorZoneBase)
HeaderVerbStyle	Возвращает атрибуты стиля для всех команд заголовков, отображаемых в элементе ToolZone управления. (Унаследовано от ToolZone)
Height	Возвращает или задает высоту элемента управления веб-сервера. (Унаследовано от WebControl)
ID	Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control)
IdSeparator	Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control)
InstructionText	Возвращает или задает текст в элементе ToolZone управления, который предоставляет направления для конечных пользователей. (Унаследовано от EditorZoneBase)
InstructionTextStyle	Возвращает атрибуты стиля для текста инструкции, который отображается в верхней части ToolZone элемента управления. (Унаследовано от ToolZone)
IsChildControlStateCleared	Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control)
IsEnabled	Возвращает значение, указывающее, включен ли элемент управления. (Унаследовано от WebControl)
IsTrackingViewState	Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control)
IsViewStateEnabled	Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control)
LabelStyle	Возвращает атрибуты стиля для содержимого меток, которые отображаются вместе с элементами управления редактирования в элементе ToolZone управления. Производные ToolZone элементы управления, такие как CatalogZone и EditorZone, применяют стили к меткам. (Унаследовано от ToolZone)
LoadViewStateByID	Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control)
NamingContainer	Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control)
OKVerb	Получает ссылку на WebPartVerb объект, который применяет изменения редактирования к элементу управления в режиме редактирования и скрывает пользовательский интерфейс редактирования. (Унаследовано от EditorZoneBase)
Padding	Возвращает или задает атрибуты заполнения ячеек в таблице, содержащей WebPart элементы управления в зоне. (Унаследовано от WebZone)
Page	Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control)
Parent	Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control)
PartChromePadding	Возвращает или задает расстояние между содержимым WebPart элемента управления и границей элемента управления. (Унаследовано от WebZone)
PartChromeStyle	Возвращает характеристики стиля, применяемые к границам элементов управления веб-частей, содержащихся в зоне. (Унаследовано от WebZone)
PartChromeType	Возвращает или задает тип границы, которая кадрируют элементы управления веб-частей, содержащиеся в зоне. (Унаследовано от WebZone)
PartStyle	Возвращает характеристики стиля, которые применяются к границе и содержимому каждого элемента управления веб-частей, содержащегося в зоне. (Унаследовано от WebZone)
PartTitleStyle	Возвращает атрибуты стиля для содержимого строки заголовка для каждого элемента управления веб-частей, содержащегося в зоне. (Унаследовано от WebZone)
RenderClientScript	Возвращает значение, указывающее, следует ли отображать клиентский скрипт на странице веб-частей. (Унаследовано от WebZone)
RenderingCompatibility	Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control)
Site	Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control)
SkinID	Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от WebControl)
Style	Возвращает коллекцию текстовых атрибутов, которые будут отображаться как атрибут стиля во внешнем теге элемента управления веб-сервера. (Унаследовано от WebControl)
SupportsDisabledAttribute	Возвращает значение, указывающее, должен ли элемент управления задать `disabled` атрибут отрисованного HTML-элемента значение "отключено" при наличии `false`свойства элемента управленияIsEnabled. (Унаследовано от CompositeControl)
TabIndex	Возвращает или задает индекс табуляции элемента управления веб-сервера. (Унаследовано от WebControl)
TagKey	Возвращает значение, соответствующее HtmlTextWriterTag этому элементу управления веб-сервера. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebZone)
TagName	Возвращает имя тега элемента управления. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
TemplateControl	Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control)
TemplateSourceDirectory	Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control)
ToolTip	Возвращает или задает текст, отображаемый при наведении указателя мыши на элемент управления веб-сервера. (Унаследовано от WebControl)
UniqueID	Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control)
ValidateRequestMode	Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control)
VerbButtonType	Возвращает или задает тип кнопки, используемой для представления команд в зоне. (Унаследовано от WebZone)
VerbStyle	Возвращает атрибуты стиля для команд пользовательского интерфейса, связанных с элементами управления веб-частей в зоне. (Унаследовано от WebZone)
ViewState	Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control)
ViewStateIgnoresCase	Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control)
ViewStateMode	Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control)
Visible	Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде элемента пользовательского интерфейса на странице. (Унаследовано от ToolZone)
WebPartManager	Возвращает ссылку на WebPartManager элемент управления, связанный с экземпляром WebZone элемента управления на странице веб-частей. (Унаследовано от WebZone)
WebPartToEdit	Возвращает ссылку на WebPart элемент управления, который в настоящее время редактируется. (Унаследовано от EditorZoneBase)
Width	Возвращает или задает ширину элемента управления веб-сервера. (Унаследовано от WebControl)
ZoneTemplate	Предоставляет шаблон для хранения дочерних элементов управления в EditorZone формате сохраняемости страниц.

Методы

Имя	Описание
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)
Close()	Вызывается, когда пользователь щелкает закрываемую команду в заголовке зоны, этот метод завершает процесс редактирования WebPart элементов управления и возвращает режим отображения страниц веб-частей для просмотра. (Унаследовано от EditorZoneBase)
CopyBaseAttributes(WebControl)	Копирует свойства, не инкапсулированные Style объектом из указанного элемента управления веб-сервера, в элемент управления веб-сервера, из который вызывается этот метод. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
CreateChildControls()	Создает набор дочерних элементов управления, связанных с EditorZoneBase зоной. (Унаследовано от EditorZoneBase)
CreateControlCollection()	Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от Control)
CreateControlStyle()	Создает объект стиля, который используется внутри WebControl класса для реализации всех свойств, связанных со стилем. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
CreateEditorPartChrome()	Возвращает ссылку на новый EditorPartChrome объект, используемый для отрисовки элементов периферийного пользовательского EditorZoneBase интерфейса вокруг зоны. (Унаследовано от EditorZoneBase)
CreateEditorParts()	Создает все элементы управления, объявленные EditorPart в шаблоне зоны в формате сохраняемости страниц.
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 зоны и текущий режим отображения страницы веб-частей. (Унаследовано от WebZone)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRouteUrl(Object)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(String, Object)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetUniqueIDRelativeTo(Control)	Возвращает префиксированную часть UniqueID свойства указанного элемента управления. (Унаследовано от Control)
HasControls()	Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от Control)
HasEvents()	Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control)
InvalidateEditorParts()	Задает коллекцию EditorPart элементов управления, связанных с EditorZoneBase зоной `null`, в результате CreateEditorParts() чего вызывается метод для повторного создания коллекции. (Унаследовано от EditorZoneBase)
IsLiteralContent()	Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control)
LoadControlState(Object)	Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState() . (Унаследовано от Control)
LoadViewState(Object)	Загружает ранее сохраненные сведения о состоянии для зоны. (Унаследовано от EditorZoneBase)
MapPathSecure(String)	Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MergeStyle(Style)	Копирует все небланковые элементы указанного стиля в веб-элемент управления, но не перезаписывает существующие элементы стиля элемента управления. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
OnBubbleEvent(Object, EventArgs)	Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control)
OnDataBinding(EventArgs)	Вызывает событие DataBinding. (Унаследовано от Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Вызывает событие и уничтожает DisplayModeChanged все EditorPart и дочерние элементы управления в зоне при подготовке веб-страницы для ввода или выхода из режима отображения редактирования. (Унаследовано от EditorZoneBase)
OnInit(EventArgs)	Создает специализированные обработчики событий, WebPartManager используемые элементом управления на веб-странице. (Унаследовано от ToolZone)
OnLoad(EventArgs)	Вызывает событие Load. (Унаследовано от Control)
OnPreRender(EventArgs)	PreRender Вызывает событие и вызывает PerformPreRender() метод для элементов EditorPart хрома элементов элементов управления. (Унаследовано от EditorZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	SelectedWebPartChanged Вызывает событие и задает EditorParts коллекцию `null` в зоне при подготовке элемента управления для WebPart ввода или выхода из режима редактирования. (Унаследовано от EditorZoneBase)
OnUnload(EventArgs)	Вызывает событие Unload. (Унаследовано от Control)
OpenFile(String)	Возвращает используемый Stream для чтения файла. (Унаследовано от Control)
RaiseBubbleEvent(Object, EventArgs)	Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control)
RaisePostBackEvent(String)	Выполняет действия, связанные с одной из команд зоны, или вызывает событие, которое отправляет обратно на сервер. (Унаследовано от EditorZoneBase)
RecreateChildControls()	Повторно создает дочерние элементы управления, производные от CompositeControlэлемента управления. (Унаследовано от CompositeControl)
RemovedControl(Control)	Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control)
Render(HtmlTextWriter)	Отрисовывает зону в указанный HtmlTextWriter объект. (Унаследовано от EditorZoneBase)
RenderBeginTag(HtmlTextWriter)	Отрисовывает открывающий HTML-тег элемента управления зонами указанному HtmlTextWriter объекту. (Унаследовано от WebZone)
RenderBody(HtmlTextWriter)	Переопределяет базовый метод для отрисовки области тела зоны, производной от EditorZoneBase класса. (Унаследовано от EditorZoneBase)
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control)
RenderContents(HtmlTextWriter)	Отрисовывает все содержимое элемента управления зонами между начальным и конечным тегами в указанный HtmlTextWriter объект. (Унаследовано от WebZone)
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control)
RenderControl(HtmlTextWriter)	Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control)
RenderEndTag(HtmlTextWriter)	Отрисовывает html-закрывающий тег элемента управления в указанный модуль записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
RenderFooter(HtmlTextWriter)	Переопределяет базовый метод для отрисовки команд в нижнем колонтитуле ToolZone элемента управления. (Унаследовано от ToolZone)
RenderHeader(HtmlTextWriter)	Переопределяет базовый метод для предоставления специализированной отрисовки области заголовков, требуемой элементами ToolZone управления. (Унаследовано от ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Отрисовывает отдельную команду с ToolZone помощью элемента управления. (Унаследовано от ToolZone)
RenderVerbs(HtmlTextWriter)	Отрисовывает команды, которые применяются на уровне зоны. (Унаследовано от EditorZoneBase)
ResolveAdapter()	Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control)
SaveControlState()	Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control)
SaveViewState()	Сохраняет все изменения состояния представления, которые произошли после публикации страницы обратно на сервер. (Унаследовано от EditorZoneBase)
SetDesignModeState(IDictionary)	Задает данные во время разработки для элемента управления. (Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)	Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control)
SetTraceData(Object, Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Отслеживает изменения состояния представления элемента управления зонами. (Унаследовано от EditorZoneBase)

События

Имя	Описание
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)
IPostBackEventHandler.RaisePostBackEvent(String)	RaisePostBackEvent(String) Реализует метод. (Унаследовано от ToolZone)

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

Имя	Описание
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)	Определяет, доступны ли метаданные таблицы.

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

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

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

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

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