WebPartZone Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Служит основным элементом управления в наборе элементов управления веб-частей для размещения WebPart элементов управления на веб-странице.
public ref class WebPartZone : System::Web::UI::WebControls::WebParts::WebPartZoneBase
public class WebPartZone : System.Web.UI.WebControls.WebParts.WebPartZoneBase
type WebPartZone = class
inherit WebPartZoneBase
Public Class WebPartZone
Inherits WebPartZoneBase
- Наследование
Примеры
В следующем примере кода показано использование WebPartZone элемента управления на странице веб-частей. Для запуска примера кода необходимо скомпилировать этот исходный код. Вы можете скомпилировать его явным образом и поместить полученную сборку в папку bin веб-сайта или глобальный кэш сборок. Кроме того, исходный код можно поместить в папку App_Code сайта, где он будет динамически скомпилирован во время выполнения. Пошаговое руководство, демонстрирующее оба метода компиляции, см. в пошаговом руководстве по разработке и использованию пользовательского веб-сервера.
В первой части примера показан пользовательский класс, наследующий от WebPartZone класса, и который задает два свойства базовой зоны в конструкторе.
using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level=AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level=AspNetHostingPermissionLevel.Minimal)]
public class MyWebPartZone : WebPartZone
{
public MyWebPartZone()
{
base.VerbButtonType = ButtonType.Button;
base.CloseVerb.Enabled = false;
}
}
}
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.WebControls
Imports System.Web.UI
Imports System.Web
Imports System.Security.Permissions
Imports System.ComponentModel
Imports System.Collections
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class MyWebPartZone
Inherits WebPartZone
Public Sub New()
MyBase.New
MyBase.VerbButtonType = ButtonType.Button
MyBase.CloseVerb.Enabled = false
End Sub
End Class
End Namespace
Вторая часть примера показывает страницу, содержащую пользовательский WebPartZone элемент управления. Обратите внимание, что для страницы требуется специальная Register директива в верхней части страницы для ссылки на сборку, содержащую пользовательскую зону. Страница также содержит элемент, который требуется на каждой <asp:webpartmanager> странице веб-частей. Элемент <cc1:MyWebPartZone> , представляющий пользовательский WebPartZone элемент управления, содержит стандартный элемент управления ASP.NET Calendar . Так как он содержится в пределах WebPartZone зоны, Calendar элемент управления будет упакован с GenericWebPart элементом управления во время выполнения, что позволяет ему выступать в качестве WebPart элемента управления.
<%@ Page Language="C#" %>
<%@ Register TagPrefix="cc1"
Namespace="Samples.AspNet.CS.Controls"
Assembly="MyWebPartZoneCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" runat="server" />
<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
<VerbStyle Font-Italic="true" />
<PartChromeStyle BackColor="lightblue" />
<PartStyle BackColor="gray" />
<PartTitleStyle Font-Bold="true" />
<ZoneTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</ZoneTemplate>
</cc1:MyWebPartZone>
</div>
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ Register TagPrefix="cc1"
Namespace="Samples.AspNet.VB.Controls"
Assembly="MyWebPartZoneVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="WebPartManager1" runat="server" />
<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
<VerbStyle Font-Italic="true" />
<PartChromeStyle BackColor="lightblue" />
<PartStyle BackColor="gray" />
<PartTitleStyle Font-Bold="true" />
<ZoneTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</ZoneTemplate>
</cc1:MyWebPartZone>
</div>
</form>
</body>
</html>
Изучите декларативную разметку для пользовательского WebPartZone элемента управления. Обратите внимание, что в разметке можно задать различные свойства уровня зоны, как показано в следующем примере кода.
Замечание
Очень важно отметить использование <zonetemplate> элемента. Этот элемент, как описано в разделе "Примечания", требуется в пределах WebPartZone зоны для упаковки статических WebPart элементов управления, объявленных на странице.
<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
<VerbStyle Font-Italic="true" />
<PartChromeStyle BackColor="lightblue" />
<PartStyle BackColor="gray" />
<PartTitleStyle Font-Bold="true" />
<ZoneTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</ZoneTemplate>
</cc1:MyWebPartZone>
<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
<VerbStyle Font-Italic="true" />
<PartChromeStyle BackColor="lightblue" />
<PartStyle BackColor="gray" />
<PartTitleStyle Font-Bold="true" />
<ZoneTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</ZoneTemplate>
</cc1:MyWebPartZone>
Комментарии
В функции веб-частей зона — это определенный регион на веб-странице, содержащей элементы управления веб-частями. Основными функциями зоны являются создание элементов управления, содержащихся в ней, и предоставление общего пользовательского интерфейса для этих элементов управления. Общие сведения о зонах и их использовании в приложениях веб-частей см. в справочной документации по базовым WebZone и WebPartZoneBase классам, а также в разделе " Обзор набора элементов управления веб-частями".
Специальная функция WebPartZone элемента управления заключается в том, чтобы содержать WebPart элементы управления, которые образуют основной пользовательский интерфейс приложений веб-частей. Элемент WebPartZone управления можно объявить в формате сохраняемости на веб-странице, что позволяет разработчикам использовать его в качестве шаблона и добавлять другие серверные элементы управления в <asp:webpartzone> элемент. Любой тип элемента управления сервером, если он WebPartZone добавлен в зону, может функционировать как WebPart элемент управления во время выполнения. Это верно независимо от того, является ли добавленный элемент управления элементом WebPart управления, пользовательским элементом управления, пользовательским элементом управления или элементом управления ASP.NET. Дополнительные сведения см. в разделе для GenericWebPart класса.
Помимо элементов WebPart управления, элемент WebPartZone управления также предоставляет общий пользовательский интерфейс для элементов управления, которые он содержит. Этот общий пользовательский интерфейс, известный совместно как chrome, состоит из периферийных элементов пользовательского интерфейса для всех элементов управления, таких как граница, заголовок, верхний и нижний колонтитул, характеристики стиля и команды (действия пользовательского интерфейса, которые пользователь может выполнять в элементе управления, например закрыть или свести к минимуму).
Замечание
Internet Explorer может отображать высоту WebPartZone или его содержащиеся элементы управления неожиданным образом в зависимости от ориентации зоны. Дополнительные сведения см. в документации по свойствам LayoutOrientation или свойствам Height .
Класс WebPartZone получает большую часть своего поведения от базовых WebZone и WebPartZoneBase классов; он добавляет только один уникальный член, ZoneTemplate свойство. Это свойство ссылается на ITemplate объект, который является шаблоном, который позволяет разработчикам страниц определять элементы управления в зоне статически с помощью <zonetemplate> элемента в декларативной разметке страницы .aspx.
Доступность
Разметка, отображаемая по умолчанию для этого элемента управления, может не соответствовать стандартам специальных возможностей, таким как рекомендации по специальным возможностям веб-содержимого 1.0 (WCAG) приоритет 1. Дополнительные сведения о поддержке специальных возможностей для этого элемента управления см. в ASP.NET элементах управления и специальных возможностях.
Конструкторы
| Имя | Описание |
|---|---|
| WebPartZone() |
Инициализирует новый экземпляр класса WebPartZone. |
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Возвращает или задает ключ доступа, позволяющий быстро перейти к элементу управления веб-сервера. (Унаследовано от WebControl) |
| Adapter |
Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control) |
| AllowLayoutChange |
Возвращает или задает значение, указывающее, можно ли изменить макет WebPart элементов управления в пределах зоны. (Унаследовано от WebPartZoneBase) |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control) |
| Attributes |
Возвращает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
| BackColor |
Возвращает или задает цвет фона элемента управления веб-сервера. (Унаследовано от WebControl) |
| BackImageUrl |
Возвращает или задает URL-адрес фонового изображения для зоны. (Унаследовано от WebZone) |
| BindingContainer |
Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control) |
| BorderColor |
Получает или задает цвет границы WebPartZoneBase элемента управления. (Унаследовано от WebPartZoneBase) |
| BorderStyle |
Возвращает или задает тип границы, которая окружает WebPartZoneBase элемент управления. (Унаследовано от WebPartZoneBase) |
| BorderWidth |
Возвращает или задает ширину границы, которая окружает WebPartZoneBase элемент управления. (Унаследовано от WebPartZoneBase) |
| ChildControlsCreated |
Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control) |
| ClientID |
Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения ClientID свойства. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control) |
| CloseVerb |
Возвращает ссылку на WebPartVerb объект, позволяющий конечным пользователям закрыть WebPart элементы управления в зоне. (Унаследовано от WebPartZoneBase) |
| ConnectVerb |
Возвращает ссылку на WebPartVerb объект, позволяющий конечным пользователям создавать подключения между WebPart элементами управления. (Унаследовано от WebPartZoneBase) |
| Context |
HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
ControlCollection Возвращает объект, представляющий дочерние элементы управления в объекте CompositeControl. (Унаследовано от CompositeControl) |
| ControlStyle |
Возвращает стиль элемента управления веб-сервера. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| ControlStyleCreated |
Возвращает значение, указывающее, был ли Style объект создан для ControlStyle свойства. Это свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
| CssClass |
Возвращает или задает класс каскадной таблицы стилей (CSS), отображаемый элементом управления веб-сервера на клиенте. (Унаследовано от WebControl) |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control) |
| DeleteVerb |
Возвращает ссылку на WebPartVerb объект, позволяющий конечным пользователям удалять WebPart элементы управления в зоне. (Унаследовано от WebPartZoneBase) |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control) |
| DisplayTitle |
Возвращает текущее значение текста, используемого в качестве заголовка WebPartZoneBase зоны, когда сама зона отображается. (Унаследовано от WebPartZoneBase) |
| DragDropEnabled |
Возвращает значение, указывающее, можно ли WebPart перетаскивать элементы управления в зону или из нее. (Унаследовано от WebPartZoneBase) |
| DragHighlightColor |
Возвращает или задает цвет вокруг границы WebPartZoneBase зоны и его областей раскрывающегося элемента управления при перетаскивании элемента управления. (Унаследовано от WebPartZoneBase) |
| EditVerb |
Возвращает ссылку на WebPartVerb объект, позволяющий конечным пользователям изменять WebPart элементы управления в зоне. (Унаследовано от WebPartZoneBase) |
| EmptyZoneText |
Возвращает или задает сообщение, которое отображается, когда WebPartZoneBase элемент управления не WebPart содержит элементов управления. (Унаследовано от WebPartZoneBase) |
| EmptyZoneTextStyle |
Возвращает атрибуты стиля для текста заполнителя в пустой зоне. (Унаследовано от WebZone) |
| Enabled |
Возвращает или задает значение, указывающее, включен ли элемент управления веб-сервера. (Унаследовано от WebControl) |
| EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
| EnableViewState |
Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control) |
| ErrorStyle |
Возвращает атрибуты стиля для отрисовки сообщения об ошибке, отображаемого WebPart , если элемент управления не может быть загружен или создан. (Унаследовано от WebZone) |
| Events |
Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| ExportVerb |
Возвращает ссылку на WebPartVerb объект, позволяющий конечным пользователям экспортировать XML-файл определения для каждого WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| Font |
Возвращает свойства шрифта, связанные с элементом управления веб-сервера. (Унаследовано от WebControl) |
| FooterStyle |
Возвращает атрибуты стиля для содержимого нижнего колонтитула зоны. (Унаследовано от WebZone) |
| ForeColor |
Возвращает или задает цвет переднего плана (обычно цвет текста) элемента управления веб-сервера. (Унаследовано от WebControl) |
| HasAttributes |
Возвращает значение, указывающее, имеет ли элемент управления набор атрибутов. (Унаследовано от WebControl) |
| HasChildViewState |
Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control) |
| HasFooter |
Возвращает значение, указывающее, имеет ли зона область нижнего колонтитула. (Унаследовано от WebPartZoneBase) |
| HasHeader |
Возвращает значение, указывающее, имеет ли зона область заголовка. (Унаследовано от WebPartZoneBase) |
| HeaderStyle |
Возвращает атрибуты стиля для содержимого области заголовка зоны. (Унаследовано от WebZone) |
| HeaderText |
Возвращает или задает текст для области заголовка зоны. (Унаследовано от WebZone) |
| Height |
Возвращает или задает высоту элемента управления веб-сервера. (Унаследовано от WebControl) |
| HelpVerb |
Возвращает ссылку на объект, используемый для доступа к содержимому WebPartVerb справки для WebPart элементов управления в зоне. (Унаследовано от WebPartZoneBase) |
| ID |
Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control) |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control) |
| IsEnabled |
Возвращает значение, указывающее, включен ли элемент управления. (Унаследовано от WebControl) |
| IsTrackingViewState |
Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control) |
| IsViewStateEnabled |
Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| LayoutOrientation |
Возвращает или задает значение, указывающее, расположены ли элементы управления в зоне вертикально или горизонтально. (Унаследовано от WebPartZoneBase) |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control) |
| MenuCheckImageStyle |
Возвращает атрибуты стиля, применяемые к изображению флажка, который отображается в меню команд рядом с выбранным текстом команды. (Унаследовано от WebPartZoneBase) |
| MenuCheckImageUrl |
Получает или задает URL-адрес изображения, используемого в качестве флажка в меню команд каждого WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| MenuLabelHoverStyle |
Возвращает атрибуты стиля, применяемые к метке меню команд в строке заголовка WebPart элемента управления, когда пользователь помещает указатель мыши на метку. (Унаследовано от WebPartZoneBase) |
| MenuLabelStyle |
Возвращает сведения о стиле для метки раскрывающегося меню команд, которое отображается в строке заголовка каждого WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| MenuLabelText |
Возвращает или задает значение, которое служит меткой раскрывающегося меню команд в строке заголовка каждого WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| MenuPopupImageUrl |
Возвращает или задает URL-адрес изображения, открывающего раскрывающееся меню команд в строке заголовка каждого WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| MenuPopupStyle |
Возвращает атрибуты стиля для раскрывающегося меню команд, которое отображается в WebPart элементах управления в зоне. (Унаследовано от WebPartZoneBase) |
| MenuVerbHoverStyle |
Возвращает сведения о стиле для внешнего вида команды в раскрывающемся меню команд, когда конечный пользователь размещает указатель мыши над командой. (Унаследовано от WebPartZoneBase) |
| MenuVerbStyle |
Возвращает сведения о стиле для внешнего вида команды в раскрывающемся меню команд при отображении меню. (Унаследовано от WebPartZoneBase) |
| MinimizeVerb |
Получает ссылку на WebPartVerb объект, позволяющий конечным пользователям свести к минимуму WebPart элементы управления в зоне. (Унаследовано от WebPartZoneBase) |
| NamingContainer |
Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control) |
| 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) |
| RestoreVerb |
Возвращает ссылку на WebPartVerb объект, позволяющий конечным пользователям восстанавливать WebPart элементы управления в зоне до нормального размера. (Унаследовано от WebPartZoneBase) |
| SelectedPartChromeStyle |
Возвращает сведения о стиле для внешнего вида выбранного WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| ShowTitleIcons |
Возвращает или задает значение, указывающее, отображаются ли значки заголовка в строке заголовка каждого WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| Site |
Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от WebControl) |
| Style |
Возвращает коллекцию текстовых атрибутов, которые будут отображаться как атрибут стиля во внешнем теге элемента управления веб-сервера. (Унаследовано от WebControl) |
| SupportsDisabledAttribute |
Возвращает значение, указывающее, должен ли элемент управления задать |
| TabIndex |
Возвращает или задает индекс табуляции элемента управления веб-сервера. (Унаследовано от WebControl) |
| TagKey |
Возвращает значение, соответствующее HtmlTextWriterTag этому элементу управления веб-сервера. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebZone) |
| TagName |
Возвращает имя тега элемента управления. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| TitleBarVerbButtonType |
Возвращает или задает тип кнопки, используемой для команд в строке заголовка WebPart элементов управления. (Унаследовано от WebPartZoneBase) |
| TitleBarVerbStyle |
Возвращает атрибуты стиля для команд в строке WebPart заголовка элемента управления. (Унаследовано от WebPartZoneBase) |
| ToolTip |
Возвращает или задает текст, отображаемый при наведении указателя мыши на элемент управления веб-сервера. (Унаследовано от WebControl) |
| UniqueID |
Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control) |
| VerbButtonType |
Возвращает или задает тип кнопки, связанной с командами, существующими в WebPartZoneBase зоне при доступе к более старому браузеру. (Унаследовано от WebPartZoneBase) |
| VerbStyle |
Возвращает атрибуты стиля для команд пользовательского интерфейса, связанных с элементами управления веб-частей в зоне. (Унаследовано от WebZone) |
| ViewState |
Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control) |
| Visible |
Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде пользовательского интерфейса на странице. (Унаследовано от Control) |
| WebPartChrome |
Возвращает ссылку на объект, определяющий периферийную WebPartChrome отрисовку для WebPart элементов управления в зоне. (Унаследовано от WebPartZoneBase) |
| WebPartManager |
Возвращает ссылку на WebPartManager элемент управления, связанный с экземпляром WebZone элемента управления на странице веб-частей. (Унаследовано от WebZone) |
| WebParts |
Возвращает коллекцию элементов управления веб-частей, содержащихся в зоне. (Унаследовано от WebPartZoneBase) |
| WebPartVerbRenderMode |
Возвращает или задает значение, указывающее, как команды должны отображаться в WebPart элементах управления в зоне. (Унаследовано от WebPartZoneBase) |
| Width |
Возвращает или задает ширину элемента управления веб-сервера. (Унаследовано от WebControl) |
| ZoneTemplate |
Возвращает или задает ссылку на ITemplate экземпляр, содержащий элементы управления, объявленные в разметке веб-страницы. |
Методы
| Имя | Описание |
|---|---|
| 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 значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control) |
| CloseWebPart(WebPart) |
Закрывает выбранный WebPart элемент управления в зоне. (Унаследовано от WebPartZoneBase) |
| ConnectWebPart(WebPart) |
Инициирует процесс создания соединения между двумя WebPart элементами управления. (Унаследовано от WebPartZoneBase) |
| CopyBaseAttributes(WebControl) |
Копирует свойства, не инкапсулированные Style объектом из указанного элемента управления веб-сервера, в элемент управления веб-сервера, из который вызывается этот метод. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateChildControls() |
Создает набор дочерних элементов управления, содержащихся в зоне. (Унаследовано от WebPartZoneBase) |
| CreateControlCollection() |
ControlCollection Создает объект, содержащий все элементы управления в зоне. (Унаследовано от WebPartZoneBase) |
| CreateControlStyle() |
Создает набор характеристик стиля, применяемых к элементу управления зонами, когда он отображается. (Унаследовано от WebPartZoneBase) |
| CreateWebPartChrome() |
Позволяет производным зонам заменить пользовательский WebPartChrome объект для изменения внешнего вида WebPart элементов управления в зоне. (Унаследовано от WebPartZoneBase) |
| DataBind() |
Привязывает источник данных ко всем дочерним CompositeControl элементам управления. (Унаследовано от CompositeControl) |
| DataBind(Boolean) |
Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control) |
| DeleteWebPart(WebPart) |
Удаляет выбранный WebPart элемент управления в зоне. (Унаследовано от WebPartZoneBase) |
| Dispose() |
Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control) |
| EditWebPart(WebPart) |
Инициирует процесс редактирования выбранного WebPart элемента управления в зоне. (Унаследовано от WebPartZoneBase) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control) |
| EnsureID() |
Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindControl(String, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| Focus() |
Задает фокус ввода элементу управления. (Унаследовано от Control) |
| GetDesignModeState() |
Возвращает данные во время разработки для элемента управления. (Унаследовано от Control) |
| GetEffectiveChromeType(Part) |
Возвращает фактическое или эффективное текущее PartChromeType значение элемента управления, учитывая PartChromeType свойство WebPart зоны и текущий режим отображения страницы веб-частей. (Унаследовано от WebPartZoneBase) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetInitialWebParts() |
Переопределяет абстрактный базовый метод и получает начальный набор статических WebPart элементов управления, содержащихся в шаблоне зоны. |
| 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) |
Загружает ранее сохраненные сведения о состоянии для зоны. (Унаследовано от WebPartZoneBase) |
| MapPathSecure(String) |
Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MergeStyle(Style) |
Копирует все небланковые элементы указанного стиля в веб-элемент управления, но не перезаписывает существующие элементы стиля элемента управления. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| MinimizeWebPart(WebPart) |
Сводит к минимуму выбранный WebPart элемент управления в зоне. (Унаследовано от WebPartZoneBase) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnCreateVerbs(WebPartVerbsEventArgs) |
Вызывает событие CreateVerbs. (Унаследовано от WebPartZoneBase) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnInit(EventArgs) |
Переопределяет базовый метод, чтобы указать, что зона успешно зарегистрирована в элементе WebPartManager управления. |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. (Унаследовано от WebPartZoneBase) |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает используемый Stream для чтения файла. (Унаследовано от Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control) |
| RaisePostBackEvent(String) |
Обновляет состояние текущей WebPart коллекции элементов управления в зоне на основе изменений, произошедших с момента последнего события обратной передачи. (Унаследовано от WebPartZoneBase) |
| RecreateChildControls() |
Повторно создает дочерние элементы управления, производные от CompositeControlэлемента управления. (Унаследовано от CompositeControl) |
| RemovedControl(Control) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отрисовывает зону в указанный HtmlTextWriter объект. (Унаследовано от WebPartZoneBase) |
| RenderBeginTag(HtmlTextWriter) |
Отрисовывает открывающий HTML-тег элемента управления зонами указанному HtmlTextWriter объекту. (Унаследовано от WebZone) |
| RenderBody(HtmlTextWriter) |
Переопределяет базовый метод для отрисовки области тела зоны, производной от WebPartZoneBase класса. (Унаследовано от WebPartZoneBase) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderContents(HtmlTextWriter) |
Отрисовывает все содержимое элемента управления зонами между начальным и конечным тегами в указанный HtmlTextWriter объект. (Унаследовано от WebZone) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderDropCue(HtmlTextWriter) |
Отрисовывает элементы пользовательского интерфейса, чтобы указать пользователю, где WebPart перетаскиваемый элемент управления можно удалить в пределах зоны. (Унаследовано от WebPartZoneBase) |
| RenderEndTag(HtmlTextWriter) |
Отрисовывает html-закрывающий тег элемента управления в указанный модуль записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderFooter(HtmlTextWriter) |
Переопределяет отрисовку нижнего колонтитула элемента управления зонами. (Унаследовано от WebZone) |
| RenderHeader(HtmlTextWriter) |
Переопределяет базовый метод для отрисовки заголовка WebPartZoneBase зоны, содержащей WebPart элементы управления. (Унаследовано от WebPartZoneBase) |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| RestoreWebPart(WebPart) |
Восстанавливает выбранный WebPart элемент управления, который был сведен к нормальному состоянию. (Унаследовано от WebPartZoneBase) |
| SaveControlState() |
Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет все изменения состояния представления, которые произошли после публикации страницы обратно на сервер. (Унаследовано от WebPartZoneBase) |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Начинает процесс отслеживания изменений состояния представления в зоне, чтобы они могли храниться в объекте StateBag и получать доступ через ViewState свойство. (Унаследовано от WebPartZoneBase) |
События
| Имя | Описание |
|---|---|
| CreateVerbs |
Происходит при создании команд для зоны, наследуемой WebPartZoneBase от класса. (Унаследовано от WebPartZoneBase) |
| 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). (Унаследовано от WebPartZoneBase) |
Методы расширения
| Имя | Описание |
|---|---|
| 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) |
Определяет, доступны ли метаданные таблицы. |