Бөлісу құралы:


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::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
Наследование
Производный
Реализации

Примеры

В следующем примере кода показано, как создать 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

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение false.

(Унаследовано от Panel)
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 значение 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)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

(Унаследовано от 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)

Вызывается после удаления дочернего элемента управления из коллекции 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)

Включает поведение платформы динамических данных для указанного элемента управления данными.

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

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