WebPart Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Служит базовым классом для настраиваемых элементов управления веб-частей ASP.NET, добавляя к возможностям базового класса Part некоторые дополнительные свойства пользовательского интерфейса, возможность создавать подключения и поведение для персонализации.
public ref class WebPart abstract : System::Web::UI::WebControls::WebParts::Part, System::Web::UI::WebControls::WebParts::IWebActionable, System::Web::UI::WebControls::WebParts::IWebEditable, System::Web::UI::WebControls::WebParts::IWebPartpublic abstract class WebPart : System.Web.UI.WebControls.WebParts.Part, System.Web.UI.WebControls.WebParts.IWebActionable, System.Web.UI.WebControls.WebParts.IWebEditable, System.Web.UI.WebControls.WebParts.IWebParttype WebPart = class
inherit Part
interface IWebPart
interface IWebActionable
interface IWebEditablePublic MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart- Наследование
- Производный
- Реализации
Примеры
В следующем примере кода показано, как создать WebPart элемент управления и сослаться на него на веб-странице.
Первая часть примера содержит код для пользовательского WebPart элемента управления с именем TextDisplayWebPart. Этот элемент управления демонстрирует создание простого пользовательского WebPart элемента управления, предоставляющего доступ к функциям набора элементов управления веб-частей. Чтобы выполнить пример кода, необходимо скомпилировать этот исходный код. Вы можете скомпилировать его явным образом и поместить полученную сборку в папку Bin веб-сайта или глобальный кэш сборок. Кроме того, исходный код можно поместить в папку App_Code сайта, где он будет динамически компилироваться во время выполнения. В этом примере кода предполагается, что исходный код компилируется в сборку, помещаете его во вложенную папку Bin веб-приложения и ссылаетесь на сборку Register с помощью директивы на веб-странице. Пошаговое руководство, демонстрирующее оба метода компиляции, см. в разделе Пошаговое руководство. Разработка и использование пользовательского серверного веб-элемента управления.
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 TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[Personalizable(), WebBrowsable]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor =
System.Drawing.Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
ChildControlsCreated = true;
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
_contentText = input.Text + @"<br />";
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.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 TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Public Sub New()
Me.AllowClose = False
End Sub
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.Text = Me.ContentText
DisplayContent.BackColor = _
System.Drawing.Color.LightBlue
Me.Controls.Add(DisplayContent)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
ChildControlsCreated = True
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
_contentText = input.Text & "<br />"
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Во второй части примера показано, как ссылаться на TextDisplayWebPart элемент управления на веб-странице ASP.NET. Обратите внимание, что многие из различных WebPart свойств можно назначить пользовательскому элементу управления декларативно.
<%@ page language="C#" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS"%>
<!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 id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" 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:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB"%>
<!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 id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" 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:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Комментарии
При создании элементов управления с функциональными возможностями веб-частей доступны два основных варианта. Можно создавать пользовательские элементы управления, производные WebPart от класса , или создавать или использовать другие серверные элементы управления. Существующие элементы управления ASP.NET, пользовательские серверные элементы управления и пользовательские элементы управления могут быть полностью функциональными возможностями веб-частей, объявляя их в пределах (или добавляя их программными средствами) WebPartZone в элемент управления зоны, в результате чего они будут упакованы с GenericWebPart объектами во время выполнения и рассматриваться как истинные WebPart элементы управления. Дополнительные сведения см. в документации по классу GenericWebPart . Для ускорения разработки и максимального повторного использования кода можно использовать существующие серверные элементы управления. Для максимального программного контроля над поведением и функциональными возможностями веб-частей элементов управления создание пользовательского элемента управления, наследуемого WebPart от класса, часто является лучшим вариантом.
Абстрактный WebPart класс наследует от базового Part элемента управления и предоставляет базовые элементы для всех WebPart элементов управления. Класс содержит общий набор свойств, влияющих на внешний вид пользовательского интерфейса. Свойства AllowClose, AllowConnect, AllowEdit, AllowHide, AllowMinimizeи AllowZoneChange определяют, разрешено ли пользователю веб-приложения взаимодействовать с элементом управления частью таким образом, как указано заданным именем свойства. CatalogIconImageUrlСвойства , ChromeState, ChromeType, Description, HeightHelpUrl, , Hidden, Title, TitleIconImageUrl, TitleUrl, и Width определяют размер, видимость, внешний вид и вспомогательное содержимое (например, заголовок и описание) элемента WebPart управления.
Связь элемента управления с его контекстом WebPart в наборе элементов управления веб-частей определяется такими свойствами, как WebPartManager, который содержит ссылку на связанный WebPartManager объект элемента управления, и Zone, который ссылается на WebZone объект , содержащий элемент управления . На странице может быть только один WebPartManager элемент управления, и каждый экземпляр WebPart элемента управления может находиться только в пределах одного WebZone за раз.
Примечание
Элемент WebPart управления можно разместить за пределами зоны на веб-странице, но в этом случае он работает как обычный серверный элемент управления и теряет почти все функциональные возможности веб-частей.
Некоторые другие важные свойства влияют на уникальные WebPart функции элементов управления. Свойство AuthorizationFilter позволяет разработчикам задать произвольную строку, которую можно использовать в качестве фильтра во время выполнения, чтобы определить, добавляется ли элемент управления на страницу. Свойство , используемое вместе с такой функцией, как управление ролями, AuthorizationFilter предоставляет полезный механизм для создания представлений на основе определенных ролей пользователей. Свойство ExportMode указывает, экспортируются ли во время экспорта все доступные данные свойств элемента управления или только не конфиденциальные данные. Это позволяет разработчикам различать конфиденциальные данные и данные, которые не являются, в целях безопасности. Свойство WebBrowsableObject возвращает ссылку на экземпляр WebPart элемента управления, чтобы EditorPart элемент управления смог изменить его, когда страница находится в режиме редактирования. Наконец, есть несколько свойств, которые указывают состояние элемента управления относительно остальной части страницы. Свойство IsClosed указывает, закрыт ли элемент управления (и, таким образом, добавлен в PageCatalogPart объект) или он открыт и доступен на странице. Свойство IsShared указывает, является ли элемент управления общим (по сравнению с пользовательским элементом управления), то есть он виден всем пользователям веб-страницы. Свойство IsStandalone указывает, содержится ли элемент управления в настоящее время в производной WebPartZoneBaseзоне (например WebPartZone, ). Значение false указывает, что элемент управления находится внутри зоны и, таким образом, имеет полную функциональность веб-частей. Свойство IsStatic указывает, является ли элемент управления статическим или динамическим. Статический элемент управления объявляется в разметке веб-страницы, тогда как динамический элемент управления добавляется программным способом.
Класс WebPart также предоставляет несколько методов, которые определяют, что происходит в различных точках жизненного цикла элемента управления. Например, OnConnectModeChanged методы и OnEditModeChanged можно переопределить в производном классе, чтобы обеспечить программный контроль над отображением содержимого элемента управления во время события, соответствующего имени каждого метода.
Классы, производные от , WebPart могут добавлять WebPartVerb объекты в коллекцию Verbs . Команды отображаются в меню глаголов, которое отображается в строке заголовка WebPart элемента управления . WebPartVerb Объекты предоставляют простые элементы пользовательского интерфейса для стандартных действий пользователя, таких как скрытие, минимизация элемента управления или отображение справки.
Метод CreateEditorParts создает коллекцию всех пользовательских EditorPart элементов управления, связанных с элементом WebPart управления. Разработчики могут переопределить этот метод, чтобы он создавал пользовательские элементы управления, предназначенные специально для редактирования их WebPart элементов управления. Метод вызывается, когда пользователь щелкает команду редактирования в элементе WebPart управления .
Конструкторы
| WebPart() |
Инициализирует класс для использования экземпляром унаследованного класса. Этот конструктор может вызываться только унаследованным классом. |
Свойства
| AccessKey |
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl) |
| Adapter |
Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control) |
| AllowClose |
Получает или задает значение, указывающее возможность закрытия конечным пользователем элемента управления WebPart на веб-странице. |
| AllowConnect |
Получает или задает значение, указывающее, разрешает ли элемент управления WebPart другим элементам управления создавать к нему подключения. |
| AllowEdit |
Получает или задает значение, указывающее возможность изменения элемента управления WebPart посредством пользовательского интерфейса, предоставленного одним или несколькими элементами управления EditorPart. |
| AllowHide |
Получает или задает значение, указывающее возможность скрытия конечным пользователем элемента управления WebPart. |
| AllowMinimize |
Получает или задает значение, указывающее, может ли конечный пользователь сворачивать элемент управления WebPart. |
| AllowZoneChange |
Получает или задает значение, указывающее, может ли пользователь перемещать элемент управления WebPart между зонами WebPartZoneBase. |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control) |
| Attributes |
Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
| AuthorizationFilter |
Получает или задает произвольную строку для определения, является ли элемент управления WebPart авторизованным для добавления на страницу. |
| BackColor |
Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl) |
| BackImageUrl |
Получает или задает URL-адрес фонового изображения для элемента управления панели. (Унаследовано от Panel) |
| BindingContainer |
Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control) |
| BorderColor |
Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl) |
| BorderStyle |
Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl) |
| BorderWidth |
Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl) |
| CatalogIconImageUrl |
Получает или задает URL-адрес изображения, которое представляет элемент управления веб-частей в каталоге элементов управления. |
| ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
| ChromeState |
Получает или задает значение, указывающее, находится ли элемент управления веб-частей в свернутом или обычном состоянии. |
| ChromeType |
Получает или задает тип границы, которая обрамляет элемент управления веб-частей. |
| ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
| ConnectErrorMessage |
Возвращает сообщение об ошибке для отображения пользователям, если во время подключения возникают ошибки. |
| Context |
Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
Получает объект ControlCollection, который содержит дочерние элементы управления для заданного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от Part) |
| ControlStyle |
Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| ControlStyleCreated |
Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
| CssClass |
Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl) |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control) |
| DefaultButton |
Получает или задает идентификатор для кнопки по умолчанию, содержащейся в элементе управления Panel. (Унаследовано от Panel) |
| Description |
Получает или задает краткую фразу, в которой говорится, что делает этот элемент управления веб-частей. Эта фраза будет использоваться во всплывающих подсказках и каталогах элементов управления веб-частей. |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control) |
| Direction |
Получает или задает горизонтальное направление, в котором перемещается содержимое в элементе управления. |
| DisplayTitle |
Возвращает строку, содержащую полный текст заголовка, который фактически отображается в заголовке окна экземпляра элемента управления WebPart. |
| Enabled |
Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl) |
| EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
| EnableViewState |
Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| ExportMode |
Получает или задает значение, указывающее, можно ли экспортировать все свойства элемента управления WebPart, только некоторые из них или же вообще не экспортировать эти свойства. |
| Font |
Возвращает свойства шрифта, связанные с серверным веб-элементом управления. (Унаследовано от WebControl) |
| ForeColor |
Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl) |
| GroupingText |
Получает или задает заголовок для группы элементов управления, содержащихся в элементе управления панелью. (Унаследовано от Panel) |
| HasAttributes |
Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl) |
| HasChildViewState |
Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control) |
| HasSharedData |
Возвращает значение, которое указывает, содержит ли элемент управления WebPart какие-либо общие данные персонализации, связанные с ним. |
| HasUserData |
Возвращает значение, которое указывает, содержит ли элемент управления WebPart какие-либо данные персонализации, связанные с ним. |
| Height |
Получает или задает высоту зоны. |
| HelpMode |
Получает или задает тип пользовательского интерфейса, используемого для отображения содержимого справки для элемента управления WebPart. |
| HelpUrl |
Получает или задает URL-адрес файла справки для элемента управления WebPart. |
| Hidden |
Получает или задает значение, указывающее, отображается ли элемент управления WebPart на веб-странице. |
| HorizontalAlign |
Получает или задает выравнивание содержимого по горизонтали в пределах панели. (Унаследовано от Panel) |
| ID |
Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control) |
| ImportErrorMessage |
Получает или задает сообщение об ошибке, которое используется, если при импорте элемента управления WebPart происходят ошибки. |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control) |
| IsClosed |
Возвращает значение, которое указывает, закрыт ли в настоящее время на веб-странице элемент управления WebPart. |
| IsEnabled |
Возвращает значение, определяющее, включен ли элемент управления. (Унаследовано от WebControl) |
| IsShared |
Возвращает значение, которое указывает, является ли элемент управления WebPart общим, то есть отображается ли он для всех пользователей на веб-странице. |
| IsStandalone |
Возвращает значение, которое указывает, является ли элемент управления WebPart изолированным, то есть не содержащимся в зоне WebPartZoneBase. |
| IsStatic |
Возвращает значение, которое указывает, является ли элемент управления WebPart статическим, что означает объявление этого элемента управления в разметке страницы веб-частей, а не добавление этого элемента управления на страницу программным способом. |
| IsTrackingViewState |
Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control) |
| IsViewStateEnabled |
Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control) |
| NamingContainer |
Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control) |
| Page |
Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control) |
| Parent |
Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control) |
| RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
| ScrollBars |
Получает или задает видимость и положение полос прокрутки в элементе управления Panel. (Унаследовано от Panel) |
| Site |
Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает обложку, применяемую к элементу управления. (Унаследовано от WebControl) |
| Style |
Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl) |
| Subtitle |
Возвращает строку, которая объединены со значением свойства Title для формирования полного заголовка для элемента управления WebPart. |
| SupportsDisabledAttribute |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
| TabIndex |
Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl) |
| TagKey |
Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| TagName |
Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| Title |
Получает или задает заголовок элемента управления веб-частей. |
| TitleIconImageUrl |
Получает или задает URL-адрес изображения, которое используется для представления элемента управления веб-частей в заголовке окна элемента управления. |
| TitleUrl |
Получает или задает URL-адрес для дополнительных сведений об элементе управления WebPart. |
| ToolTip |
Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl) |
| UniqueID |
Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control) |
| Verbs |
Возвращает коллекцию пользовательских команд, связанных с элементом управления WebPart. |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control) |
| Visible |
Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице. (Унаследовано от Control) |
| WebBrowsableObject |
Возвращает ссылку на элемент управления WebPart для разрешения изменения этого элемента пользовательскими элементами управления EditorPart. |
| WebPartManager |
Возвращает ссылку на элемент управления WebPartManager, связанный с экземпляром элемента управления WebPart. |
| Width |
Получает или задает ширину серверного веб-элемента управления. |
| Wrap |
Получает или задает значение, показывающее, осуществляется ли перенос содержимого в пределах панели. (Унаследовано от Panel) |
| Zone |
Возвращает зону WebPartZoneBase, которая содержит в настоящее время элемент управления WebPart. |
| ZoneIndex |
Возвращает позицию индекса элемента управления WebPart в зоне. |
Методы
| AddAttributesToRender(HtmlTextWriter) |
Добавляет сведения о фоновом изображении, выравнивании, переносе по словам и направление в список обрабатываемых атрибутов. (Унаследовано от Panel) |
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control) |
| ApplyStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
| ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control) |
| CopyBaseAttributes(WebControl) |
Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateChildControls() |
Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки. (Унаследовано от Control) |
| CreateControlCollection() |
Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. (Унаследовано от Control) |
| CreateControlStyle() |
Создает объект стиля, который внутренне используется элементом управления Panel для реализации всех относящихся к стилю свойств. (Унаследовано от Panel) |
| CreateEditorParts() |
Возвращает коллекцию пользовательских элементов управления EditorPart, которые могут быть использованы для редактирования элемента управления WebPart, находящегося в режиме редактирования. |
| DataBind() |
Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления. (Унаследовано от Part) |
| DataBind(Boolean) |
Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control) |
| Dispose() |
Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control) |
| EnsureID() |
Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
| FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
| Focus() |
Задает фокус ввода на элемент управления. (Унаследовано от Control) |
| GetDesignModeState() |
Возвращает данные времени разработки для элемента управления. (Унаследовано от Control) |
| 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) |
Восстанавливает сведения о состоянии просмотра из предыдущего запроса, сохраненного с помощью метода SaveViewState(). (Унаследовано от WebControl) |
| MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MergeStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnClosing(EventArgs) |
Разрешает производным классам предоставлять пользовательскую обработку, если элемент управления WebPart закрыт на странице веб-частей. |
| OnConnectModeChanged(EventArgs) |
Разрешает производным классам предоставлять пользовательскую обработку, если элемент управления WebPart начинает или завершает процесс подключения к другим элементам управления. |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnDeleting(EventArgs) |
Разрешает производным классам предоставлять пользовательскую обработку, если элемент управления WebPart полностью удаляется со страницы веб-частей. |
| OnEditModeChanged(EventArgs) |
Разрешает производным классам предоставлять пользовательскую обработку, если элемент управления WebPart переходит в режим редактирования или выходит из него. |
| OnInit(EventArgs) |
Вызывает событие Init. (Унаследовано от Control) |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. (Унаследовано от Control) |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
| RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Выполняет визуализацию элемента управления в указанный модуль записи HTML. (Унаследовано от WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Выполняет рендеринг открывающего HTML-тега элемента управления Panel для указанного объекта. (Унаследовано от Panel) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
| RenderContents(HtmlTextWriter) |
Выводит содержимое элемента управления в заданный модуль записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
| RenderEndTag(HtmlTextWriter) |
Отображает закрывающий HTML-тег элемента управления Panel в указанное средство записи. (Унаследовано от Panel) |
| ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет любое состояние, которое было изменено после вызова метода TrackViewState(). (Унаследовано от WebControl) |
| SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
| SetPersonalizationDirty() |
Устанавливает флаг, указывающий на изменение данных персонализации для текущего экземпляра элемента управления WebPart. |
| SetPersonalizationDirty(Control) |
Устанавливает флаг, указывающий на изменение данных персонализации для указанного серверного элемента управления, который находится в зоне WebPartZoneBase. |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Заставляет элемент управления отслеживать изменения в состоянии его представления, чтобы их можно было сохранить в свойстве ViewState объекта. |
События
| 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() |
Позволяет разработчику конструктора для составного элемента управления "Веб-часть" воспроизвести дочерние элементы управления элемента управления в рабочей области конструирования. (Унаследовано от Part) |
| 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) |
Методы расширения
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |
| GetDefaultValues(INamingContainer) |
Получает коллекцию значений по умолчанию для заданного элемента управления данными. |
| GetMetaTable(INamingContainer) |
Получает метаданные таблицы для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable) |
Задает метаданные таблицы для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Определяет, доступны ли метаданные таблицы. |
| EnableDynamicData(INamingContainer, Type) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по