WebPart Класс

Определение

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

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

Важно!

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

Служит базовым классом для пользовательских элементов управления веб-частей 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::IWebPart

public 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.IWebPart

type WebPart = class
    inherit Part
    interface IWebPart
    interface IWebActionable
    interface IWebEditable

Public MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart

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

Control

WebControl

Panel

Part
WebPart

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

System.Web.UI.WebControls.WebParts.ProxyWebPart

Реализации: IWebActionable IWebEditable IWebPart

Примеры

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

Первая часть примера содержит код для пользовательского WebPart элемента управления с именем TextDisplayWebPart. В этом элементе управления показано, как создать простой пользовательский WebPart элемент управления, который предоставляет доступ к функциям набора элементов управления веб-частей. Для запуска примера кода необходимо скомпилировать этот исходный код. Вы можете скомпилировать его явным образом и поместить полученную сборку в папку bin веб-сайта или глобальный кэш сборок. Кроме того, исходный код можно поместить в папку App_Code сайта, где он будет динамически скомпилирован во время выполнения. В этом примере кода предполагается, что вы компилируете исходный код в сборку, помещаете его в вложенную папку веб-приложения и ссылаетесь на сборку с директивой 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, и AllowHide AllowEdit AllowMinimize AllowZoneChange свойства указывают, разрешен ли пользователь веб-приложения взаимодействовать с элементом управления частью таким образом, как указано заданным именем свойства. CatalogIconImageUrlСвойства , , ChromeState, Description Title Width Height ChromeType Hidden TitleIconImageUrl HelpUrl TitleUrlи определяют размер, видимость, внешний вид и вспомогательное содержимое (например, название и описание) элемента WebPart управления.

Связь WebPart элемента управления с контекстом в наборе элементов управления веб-частей определяется такими свойствами, как WebPartManager, которые содержат ссылку на связанный WebPartManager объект элемента управления, и Zoneкоторый ссылается на WebZone элемент управления, содержащий элемент управления. На каждой WebPart странице может быть только один WebPartManager элемент управления, и каждый экземпляр элемента управления может находиться только в один 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	Возвращает значение, указывающее, должен ли элемент управления задать `disabled` атрибут отрисованного HTML-элемента значение "отключено" при наличии `false`свойства элемента управленияIsEnabled. (Унаследовано от Panel)
TabIndex	Возвращает или задает индекс табуляции элемента управления веб-сервера. (Унаследовано от 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)	Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control)
AddParsedSubObject(Object)	Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control)
ApplyStyle(Style)	Копирует все небланковые элементы указанного стиля в веб-элемент управления, перезаписыв все существующие элементы стиля элемента управления. Этот метод в основном используется разработчиками элементов управления. (Унаследовано от WebControl)
ApplyStyleSheetSkin(Page)	Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)	Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control)
BuildProfileTree(String, Boolean)	Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control)
ClearCachedClientID()	Задает кэшированное ClientID значение `null`. (Унаследовано от Control)
ClearChildControlState()	Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildState()	Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildViewState()	Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearEffectiveClientIDMode()	ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control)
CopyBaseAttributes(WebControl)	Копирует свойства, не инкапсулированные Style объектом из указанного элемента управления веб-сервера, в элемент управления веб-сервера, из который вызывается этот метод. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
CreateChildControls()	Вызывается платформой страницы ASP.NET, чтобы уведомить серверные элементы управления, использующие реализацию на основе композиции, чтобы создать все дочерние элементы управления, содержащиеся в подготовке к публикации обратной или отрисовки. (Унаследовано от Control)
CreateControlCollection()	Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от Control)
CreateControlStyle()	Создает объект стиля, который используется внутри 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, Int32)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным `id` и целым числом, указанным в `pathOffset` параметре, который помогает в поиске. Эту версию FindControl метода не следует переопределять. (Унаследовано от Control)
FindControl(String)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным `id` параметром. (Унаследовано от Control)
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)	Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control)
Render(HtmlTextWriter)	Отрисовывает элемент управления в указанный модуль записи HTML. (Унаследовано от WebControl)
RenderBeginTag(HtmlTextWriter)	Отрисовывает HTML-тег открывающего элемента Panel управления указанному средству записи. (Унаследовано от Panel)
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control)
RenderContents(HtmlTextWriter)	Отрисовывает содержимое элемента управления указанному средству записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control)
RenderControl(HtmlTextWriter)	Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control)
RenderEndTag(HtmlTextWriter)	Отрисовывает html-закрывающий тег Panel элемента управления в указанный модуль записи. (Унаследовано от Panel)
ResolveAdapter()	Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control)
SaveControlState()	Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control)
SaveViewState()	Сохраняет любое состояние, измененное после TrackViewState() вызова метода. (Унаследовано от WebControl)
SetDesignModeState(IDictionary)	Задает данные во время разработки для элемента управления. (Унаследовано от Control)
SetPersonalizationDirty()	Задает флаг, указывающий, что данные персонализации изменились для текущего WebPart экземпляра элемента управления.
SetPersonalizationDirty(Control)	Задает флаг, указывающий, что данные персонализации изменились для указанного элемента управления сервером, который находится в WebPartZoneBase зоне.
SetRenderMethodDelegate(RenderMethod)	Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control)
SetTraceData(Object, Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(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)

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

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

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

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

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

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

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