WebPartManager Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Служит в качестве центрального класса набора элементов управления веб-частей, управляющего всеми элементами управления веб-частей, функциональностью и событиями, происходящими на веб-странице.
public ref class WebPartManager : System::Web::UI::Control, System::Web::UI::INamingContainer, System::Web::UI::WebControls::WebParts::IPersonalizable[System.ComponentModel.Bindable(false)]
public class WebPartManager : System.Web.UI.Control, System.Web.UI.INamingContainer, System.Web.UI.WebControls.WebParts.IPersonalizable[<System.ComponentModel.Bindable(false)>]
type WebPartManager = class
inherit Control
interface INamingContainer
interface IPersonalizablePublic Class WebPartManager
Inherits Control
Implements INamingContainer, IPersonalizable- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере кода показано декларативное и программное использование WebPartManager элемента управления .
Пример кода состоит из четырех частей:
Пользовательский элемент управления, позволяющий изменять режимы отображения на странице веб-частей.
Веб-страница, содержащая два настраиваемых WebPart элемента управления, которые можно подключить, и
<asp:webpartmanager>элемент .Файл исходного кода, содержащий два пользовательских WebPart элемента управления и пользовательский интерфейс.
Описание работы примера в браузере.
Пользовательский элемент управления имеет раскрывающийся список, в котором отображаются возможные режимы отображения на странице с учетом элементов управления веб-частей, присутствующих на странице. На веб-странице для этого примера кода этот пользовательский элемент управления объявляется сразу под WebPartManager элементом в разметке страницы, а в верхней части веб-страницы есть Register директива для регистрации элемента управления. Дополнительные сведения о режимах отображения и описание исходного кода в этом элементе управления см. в разделе Пошаговое руководство. Изменение режимов отображения на странице веб-частей.
<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
// Use a field to reference the current WebPartManager.
WebPartManager _manager;
void Page_Init(object sender, EventArgs e)
{
Page.InitComplete += new EventHandler(InitComplete);
}
void InitComplete(object sender, System.EventArgs e)
{
_manager = WebPartManager.GetCurrentWebPartManager(Page);
String browseModeName = WebPartManager.BrowseDisplayMode.Name;
// Fill the dropdown with the names of supported display modes.
foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
{
String modeName = mode.Name;
// Make sure a mode is enabled before adding it.
if (mode.IsEnabled(_manager))
{
ListItem item = new ListItem(modeName, modeName);
DisplayModeDropdown.Items.Add(item);
}
}
// If shared scope is allowed for this user, display the scope-switching
// UI and select the appropriate radio button for the current user scope.
if (_manager.Personalization.CanEnterSharedScope)
{
Panel2.Visible = true;
if (_manager.Personalization.Scope == PersonalizationScope.User)
RadioButton1.Checked = true;
else
RadioButton2.Checked = true;
}
}
// Change the page to the selected display mode.
void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
{
String selectedMode = DisplayModeDropdown.SelectedValue;
WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
if (mode != null)
_manager.DisplayMode = mode;
}
// Set the selected item equal to the current display mode.
void Page_PreRender(object sender, EventArgs e)
{
ListItemCollection items = DisplayModeDropdown.Items;
int selectedIndex =
items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
DisplayModeDropdown.SelectedIndex = selectedIndex;
}
// Reset all of a user's personalization data for the page.
protected void LinkButton1_Click(object sender, EventArgs e)
{
_manager.Personalization.ResetPersonalizationState();
}
// If not in User personalization scope, toggle into it.
protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.Scope == PersonalizationScope.Shared)
_manager.Personalization.ToggleScope();
}
// If not in Shared scope, and if user is allowed, toggle the scope.
protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.CanEnterSharedScope &&
_manager.Personalization.Scope == PersonalizationScope.User)
_manager.Personalization.ToggleScope();
}
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
AddHandler Page.InitComplete, AddressOf InitComplete
End Sub
Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
_manager = WebPartManager.GetCurrentWebPartManager(Page)
Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
' Fill the dropdown with the names of supported display modes.
Dim mode As WebPartDisplayMode
For Each mode In _manager.SupportedDisplayModes
Dim modeName As String = mode.Name
' Make sure a mode is enabled before adding it.
If mode.IsEnabled(_manager) Then
Dim item As New ListItem(modeName, modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
' If shared scope is allowed for this user, display the scope-switching
' UI and select the appropriate radio button for the current user scope.
If _manager.Personalization.CanEnterSharedScope Then
Panel2.Visible = True
If _manager.Personalization.Scope = PersonalizationScope.User Then
RadioButton1.Checked = True
Else
RadioButton2.Checked = True
End If
End If
End Sub
' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
ByVal e As EventArgs)
Dim selectedMode As String = DisplayModeDropdown.SelectedValue
Dim mode As WebPartDisplayMode = _
_manager.SupportedDisplayModes(selectedMode)
If Not (mode Is Nothing) Then
_manager.DisplayMode = mode
End If
End Sub
' Set the selected item equal to the current display mode.
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
Dim items As ListItemCollection = DisplayModeDropdown.Items
Dim selectedIndex As Integer = _
items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
DisplayModeDropdown.SelectedIndex = selectedIndex
End Sub
' Reset all of a user's personalization data for the page.
Protected Sub LinkButton1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
_manager.Personalization.ResetPersonalizationState()
End Sub
' If not in User personalization scope, toggle into it.
Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.Scope = PersonalizationScope.Shared Then
_manager.Personalization.ToggleScope()
End If
End Sub
' If not in Shared scope, and if user is allowed, toggle the scope.
Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope AndAlso _
_manager.Personalization.Scope = PersonalizationScope.User Then
_manager.Personalization.ToggleScope()
End If
End Sub
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
Декларативная разметка для веб-страницы содержит директивы Register как для пользовательского, так и для пользовательских элементов управления. Существует <asp:webpartmanager> элемент , элемент , <asp:webpartzone> содержащий пользовательские элементы управления, и <asp:connectionszone> элемент . Страница также содержит встроенный код, который обрабатывает события, связанные с подключением, для WebPartManager элемента управления. Вы можете увидеть эффект этого кода при подключении и отключении элементов управления.
<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="ConnectionSampleCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void UpdateLabelData(int wpCount, int connCount)
{
Label1.Text = "WebPart Control Count: " + wpCount.ToString();
Label2.Text = "Connections Count: " + connCount.ToString();
}
protected void WebPartManager1_WebPartsConnected(object sender, WebPartConnectionsEventArgs e)
{
UpdateLabelData(WebPartManager1.WebParts.Count,
WebPartManager1.Connections.Count);
}
protected void WebPartManager1_WebPartsDisconnected(object sender, WebPartConnectionsEventArgs e)
{
UpdateLabelData(WebPartManager1.WebParts.Count,
WebPartManager1.Connections.Count);
}
</script>
<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">
<!-- Reference the WebPartManager control. -->
<asp:WebPartManager ID="WebPartManager1" runat="server"
OnWebPartsConnected="WebPartManager1_WebPartsConnected"
OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
<div>
<uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
<!-- Reference consumer and provider controls in a zone. -->
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<aspSample:ZipCodeWebPart ID="zip1"
runat="server"
Title="Zip Code Control"/>
<aspSample:WeatherWebPart ID="weather1"
runat="server"
Title="Weather Control" />
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<asp:Label ID="Label1" runat="server" Text=""></asp:Label>
<br />
<asp:Label ID="Label2" runat="server" Text=""></asp:Label>
<!-- Add a ConnectionsZone so users can connect controls. -->
<asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
</div>
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="ConnectionSampleVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub WebPartManager1_WebPartsConnected( _
ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
UpdateLabelData(WebPartManager1.WebParts.Count, _
WebPartManager1.Connections.Count)
End Sub
Protected Sub WebPartManager1_WebPartsDisconnected( _
ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
UpdateLabelData(WebPartManager1.WebParts.Count, _
WebPartManager1.Connections.Count)
End Sub
Private Sub UpdateLabelData(ByVal wpCount As Integer, _
ByVal connCount As Integer)
Label1.Text = "WebPart Control Count: " & wpCount.ToString()
Label2.Text = "Connections Count: " & connCount.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<!-- Reference the WebPartManager control. -->
<asp:WebPartManager ID="WebPartManager1" runat="server" OnWebPartsConnected="WebPartManager1_WebPartsConnected" OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
<div>
<uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
<!-- Reference consumer and provider controls in a zone. -->
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<aspSample:ZipCodeWebPart ID="zip1"
runat="server"
Title="Zip Code Control"/>
<aspSample:WeatherWebPart ID="weather1"
runat="server"
Title="Weather Control" />
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<asp:Label ID="Label1" runat="server" Text=""></asp:Label>
<br />
<asp:Label ID="Label2" runat="server" Text=""></asp:Label>
<!-- Add a ConnectionsZone so users can connect controls. -->
<asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
</div>
</form>
</body>
</html>
Третья часть примера — исходный код для элементов управления. Обратите внимание, что существует интерфейс с именем IZipCode, и этот интерфейс реализован в ZipCodeWebPart классе . Этот класс имеет специальный метод обратного вызова с именем ProvideIZipCode , который выступает в качестве поставщика. Другой тип с именем WeatherWebPartтакже реализуется с помощью специального метода с именем GetIZipCode, который позволяет элементу управления действовать как потребитель другого элемента управления.
Для выполнения примера кода необходимо скомпилировать этот исходный код. Ее можно скомпилировать явным образом и поместить полученную сборку в папку Bin веб-сайта или глобальный кэш сборок. Кроме того, исходный код можно поместить в папку App_Code сайта, где он будет динамически компилироваться во время выполнения. В этом примере кода предполагается, что вы скомпилировали источник в сборку, а директива Register на веб-странице ссылается на имя сборки. Пошаговое руководство, демонстрирующее компиляцию, см. в разделе Пошаговое руководство. Разработка и использование пользовательского серверного веб-элемента управления.
namespace Samples.AspNet.CS.Controls
{
using System;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public interface IZipCode
{
string ZipCode { get; set;}
}
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class ZipCodeWebPart : WebPart, IZipCode
{
string zipCodeText = String.Empty;
TextBox input;
Button send;
public ZipCodeWebPart()
{
}
// Make the implemented property personalizable to save
// the Zip Code between browser sessions.
[Personalizable()]
public virtual string ZipCode
{
get { return zipCodeText; }
set { zipCodeText = value; }
}
// This is the callback method that returns the provider.
[ConnectionProvider("Zip Code")]
public IZipCode ProvideIZipCode()
{
return this;
}
protected override void CreateChildControls()
{
Controls.Clear();
input = new TextBox();
this.Controls.Add(input);
send = new Button();
send.Text = "Enter 5-digit Zip Code";
send.Click += new EventHandler(this.submit_Click);
this.Controls.Add(send);
}
private void submit_Click(object sender, EventArgs e)
{
if (!string.IsNullOrEmpty(input.Text))
{
zipCodeText = Page.Server.HtmlEncode(input.Text);
input.Text = String.Empty;
}
}
}
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class WeatherWebPart : WebPart
{
private IZipCode _provider;
string _zipSearch;
Label DisplayContent;
// This method is identified by the ConnectionConsumer
// attribute, and is the mechanism for connecting with
// the provider.
[ConnectionConsumer("Zip Code")]
public void GetIZipCode(IZipCode Provider)
{
_provider = Provider;
}
protected override void OnPreRender(EventArgs e)
{
EnsureChildControls();
if (this._provider != null)
{
_zipSearch = _provider.ZipCode.Trim();
DisplayContent.Text = "My Zip Code is: " + _zipSearch;
}
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
this.Controls.Add(DisplayContent);
}
}
}
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
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 Interface IZipCode
Property ZipCode() As String
End Interface
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class ZipCodeWebPart
Inherits WebPart
Implements IZipCode
Private zipCodeText As String = String.Empty
Private input As TextBox
Private send As Button
Public Sub New()
End Sub
' Make the implemented property personalizable to save
' the Zip Code between browser sessions.
<Personalizable()> _
Public Property ZipCode() As String _
Implements IZipCode.ZipCode
Get
Return zipCodeText
End Get
Set(ByVal value As String)
zipCodeText = value
End Set
End Property
' This is the callback method that returns the provider.
<ConnectionProvider("Zip Code")> _
Public Function ProvideIZipCode() As IZipCode
Return Me
End Function
Protected Overrides Sub CreateChildControls()
Controls.Clear()
input = New TextBox()
Me.Controls.Add(input)
send = New Button()
send.Text = "Enter 5-digit Zip Code"
AddHandler send.Click, AddressOf Me.submit_Click
Me.Controls.Add(send)
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
If input.Text <> String.Empty Then
zipCodeText = Page.Server.HtmlEncode(input.Text)
input.Text = String.Empty
End If
End Sub
End Class
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class WeatherWebPart
Inherits WebPart
Private _provider As IZipCode
Private _zipSearch As String
Private DisplayContent As Label
' This method is identified by the ConnectionConsumer
' attribute, and is the mechanism for connecting with
' the provider.
<ConnectionConsumer("Zip Code")> _
Public Sub GetIZipCode(ByVal Provider As IZipCode)
_provider = Provider
End Sub
Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
EnsureChildControls()
If Not (Me._provider Is Nothing) Then
_zipSearch = _provider.ZipCode.Trim()
DisplayContent.Text = "My Zip Code is: " + _zipSearch
End If
End Sub
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
Me.Controls.Add(DisplayContent)
End Sub
End Class
End Namespace
Загрузив веб-страницу в браузере, щелкните раскрывающийся список Режим отображения и выберите Подключить , чтобы переключить страницу в режим подключения. В режиме <asp:connectionszone> подключения элемент используется для создания соединений между элементами управления. В режиме подключения щелкните стрелку вниз в заголовке окна элемента управления Почтовый индекс , чтобы активировать меню команд, а затем выберите подключиться. Когда появится пользовательский интерфейс подключения, щелкните ссылку Создать подключение к объекту-получателю . Появится ячейка с элементом управления раскрывающимся списком. Выберите Управление погодой в раскрывающемся списке и нажмите кнопку Подключить , чтобы завершить соединение двух элементов управления. Нажмите кнопку Закрыть, а затем используйте раскрывающийся список Режим отображения , чтобы вернуть страницу в обычный режим просмотра. Вы можете ввести почтовый индекс, и элемент управления потребителем будет обновлен с помощью введенного значения. ZipCode Так как свойство было отмечено атрибутом Personalizable в исходном коде, это значение свойства будет сохраняться в сеансах браузера, сохраняя таким образом значение, введенное пользователем. Более сложный контроль потребителей может принимать сведения о почтовом индексе, искать информацию о погоде на основе кода и отображать ее пользователю.
Комментарии
Элемент WebPartManager управления выступает в качестве центра или центра управления приложения веб-частей. На каждой странице, где используются элементы управления веб-частейWebPartManager , должен быть один и только один экземпляр элемента управления. Как и большинство аспектов приложений веб-частей, WebPartManager элемент управления работает только с пользователями, прошедшими проверку подлинности. Кроме того, его функции почти полностью работают с серверными элементами управления, которые находятся в зонах веб-частей, наследующих WebZone от класса . Серверные элементы управления, находящиеся на странице за пределами этих зон, могут иметь очень мало функциональных возможностей веб-частей или взаимодействия с элементом WebPartManager управления.
В качестве концентратора для веб-частей на странице элемент управления выполняет типы задач, WebPartManager описанные в следующей таблице.
| Категория задач | Что делает элемент управления |
|---|---|
| Отслеживание элементов управления веб-частей | Отслеживает множество различных типов элементов управления на странице, которые предоставляют функции веб-частей, включая WebPart элементы управления, подключения, зоны и т. д. |
| Добавление и удаление элементов управления веб-частей | Предоставляет методы для добавления, удаления и закрытия WebPart элементов управления на странице. |
| Администрирование подключений | Создает соединения между элементами управления и отслеживает подключения, а также процессы их добавления и удаления. |
| Персонализация элементов управления и страниц | Позволяет пользователям перемещать элементы управления в разные расположения на странице и запускает представления, в которых пользователи могут изменять внешний вид, свойства и поведение элементов управления. Поддерживает пользовательские параметры персонализации на каждой странице. |
| Переключение между различными представлениями страниц | Переключает страницу между различными специализированными представлениями страницы, чтобы пользователи могли выполнять определенные задачи, такие как изменение макета страницы или редактирование элементов управления. |
| Создание событий жизненного цикла веб-частей | Определяет, создает и позволяет разработчикам обрабатывать события жизненного цикла элементов управления веб-частей, например при добавлении, перемещении, подключении или удалении элементов управления. |
| Включение импорта и экспорта элементов управления | Экспортирует XML-потоки, содержащие состояние свойств WebPart элементов управления, и позволяет пользователям импортировать файлы для удобства при персонализации сложных элементов управления на других страницах или сайтах. |
Класс WebPartManager имеет большой набор свойств. В соответствии с ролью WebPartManager отслеживания других элементов управления он имеет ряд свойств, ссылающихся на коллекции элементов управления веб-частей или других специальных объектов веб-частей. Свойства AvailableTransformers, Connections, Controls, DisplayModes, DynamicConnections, SupportedDisplayModes, WebPartsи Zones — это все коллекции, используемые элементом WebPartManager управления для отслеживания и других задач управления.
Другая группа свойств содержит настраиваемые предупреждения, которые применяются в определенных сценариях, возникающих в приложении веб-частей. К ним относятся CloseProviderWarningсвойства , DeleteWarningи ExportSensitiveDataWarning .
Класс WebPartManager переопределяет некоторые из своих базовых унаследованных свойств, которые используются многими серверными веб-элементами управления. К ним относятся EnableThemingсвойства , SkinIDи Visible .
Наконец, существует группа свойств, полезных для доступа к текущему состоянию приложения. Свойство DisplayMode указывает текущий режим отображения, в котором находится страница. Свойство EnableClientScript указывает, разрешено ли элементу управления выполнять отрисовку клиентского скрипта, что актуально в ситуациях, когда у пользователей могут быть браузеры с разными возможностями или отключены сценарии. Свойство Internals полезно для ссылки на служебный класс, содержащий вызовы ряда важных методов веб-частей, которые используются для вариантов расширяемости. Скрытие вызовов этих методов в отдельном WebPartManagerInternals классе (классе) WebPartManager упрощает собственный API класса. Свойство Personalization предоставляет доступ к объектам персонализации, которые хранят параметры персонализации пользователей и сохраняют эти данные в постоянном хранилище. Свойство SelectedWebPart указывает, какой WebPart элемент управления на странице в данный момент выбран пользователем или приложением. Свойство IPersonalizable.IsDirty указывает, изменились ли пользовательские данные персонализации в элементе WebPart управления.
Элемент WebPartManager управления содержит пять встроенных режимов отображения или представлений веб-страницы. Разработчики могут расширить эту функцию, создавая настраиваемые режимы отображения, расширяя типы, такие как WebZone класс или ToolZone класс . Пользователи могут переключать страницу в различные режимы отображения при условии, что на странице присутствуют соответствующие элементы управления, соответствующие заданному режиму отображения.
Примечание
Эту функцию можно расширить, чтобы пользователи могли переключиться в пользовательский режим отображения без соответствующей зоны на странице. Однако по умолчанию режимы отображения соответствуют зонам.
Стандартные режимы отображения представлены открытыми полями в WebPartManager классе . В следующей таблице перечислены поля и режимы отображения, на которые они ссылаются. Текущий режим отображения страницы, как отмечалось выше, всегда указывается в DisplayMode свойстве , а набор режимов отображения, доступных на определенной странице, с учетом типа зон, присутствующих на странице, содержится в свойстве SupportedDisplayModes .
| Поле | Сведения о режиме отображения |
|---|---|
| BrowseDisplayMode | Обычное пользовательское представление веб-страницы; режим отображения по умолчанию и наиболее распространенный режим отображения. |
| DesignDisplayMode | Представление, в котором пользователи могут изменять порядок или удалять элементы управления для изменения макета страницы. |
| EditDisplayMode | Представление, в котором отображается пользовательский интерфейс редактирования; пользователи могут изменять внешний вид, свойства и поведение элементов управления, видимых в обычном режиме просмотра. |
| CatalogDisplayMode | Представление, в котором становится видимым пользовательский интерфейс каталога; пользователи могут добавлять элементы управления на страницу из каталогов доступных элементов управления. |
| ConnectDisplayMode | Представление, в котором отображается пользовательский интерфейс подключения; пользователи могут подключаться, управлять и отключать подключения между элементами управления. |
Элемент WebPartManager управления также содержит ряд событий, критически важных в жизненном цикле страниц веб-частей и элементов управления. Эти события обеспечивают точный программный контроль над поведением элементов управления веб-частей. Большинство методов относятся непосредственно к WebPart элементам управления (или другим серверным или пользовательским элементам управления, размещенным в WebPartZoneBase зонах, чтобы они могли вести себя как WebPart элементы управления). Однако некоторые события относятся к состоянию страницы или подключений на ней. В следующей таблице перечислены доступные события и приведены их цели.
Примечание
Во всех случаях в следующей таблице слово "control" означает элемент управления или любой WebPart серверный элемент управления, расположенный в зоне и заключенный в оболочку GenericWebPart с объектом во время выполнения.
| Событие | Описание |
|---|---|
| AuthorizeWebPart | Происходит непосредственно перед добавлением элемента управления на страницу, чтобы убедиться, что он авторизован. |
| ConnectionsActivated | Происходит после активации всех подключений на странице. |
| ConnectionsActivating | Происходит непосредственно перед процессом активации всех подключений на странице. |
| DisplayModeChanged | Происходит после изменения текущего режима отображения страницы. |
| DisplayModeChanging | Происходит непосредственно перед процессом изменения режима отображения страницы. |
| SelectedWebPartChanged | Происходит после отмены выбора элемента управления. |
| SelectedWebPartChanging | Происходит непосредственно перед процессом отмены выбора элемента управления. |
| WebPartAdded | Происходит после добавления элемента управления в зону. |
| WebPartAdding | Происходит непосредственно перед процессом добавления элемента управления в зону. |
| WebPartClosed | Происходит после закрытия элемента управления (удаления со страницы). |
| WebPartClosing | Происходит непосредственно перед процессом закрытия элемента управления. |
| WebPartDeleted | Происходит после окончательного удаления экземпляра динамического элемента управления (созданного программным путем или добавленного из каталога). |
| WebPartDeleting | Происходит непосредственно перед процессом удаления динамического элемента управления. |
| WebPartMoved | Происходит после перемещения элемента управления в пределах своей зоны или в другую зону. |
| WebPartMoving | Происходит непосредственно перед процессом перемещения элемента управления. |
| WebPartsConnected | Происходит после установки соединения двумя элементами управления, выбранными для участия в соединении. |
| WebPartsConnecting | Происходит непосредственно перед процессом соединения двух элементов управления. |
| WebPartsDisconnected | Происходит после отключения двух подключенных элементов управления. |
| WebPartsDisconnecting | Происходит непосредственно перед процессом отключения двух элементов управления. |
Элемент WebPartManager управления содержит множество методов управления страницами веб-частей. Большой набор методов, не перечисленных здесь, — это методы, имена которых имеют вид OnEventName. Эти методы обычно вызывают связанное событие и предоставляют событию обработчик типа WebPartEventHandler. Большинство этих методов могут быть переопределены разработчиками, наследуемыми WebPartManager от класса . Кроме того, разработчики страниц могут предоставлять пользовательские обработчики для событий, связанных с этими методами. Например, в случае WebPartAdded события разработчик страницы может добавить OnWebPartAdded атрибут к элементу <asp:webpartmanager> в разметке веб-страницы, а затем присвоить атрибуту имя настраиваемого метода, чтобы обеспечить пользовательскую обработку события. Атрибут соответствует методу OnWebPartAdded , и этот базовый шаблон обработки событий работает для большинства событий веб-частей и связанных с ними методов.
Кроме того, элемент управления содержит методы, WebPartManager определенные для задачи управления WebPart элементами управления (и серверными или пользовательскими элементами управления, используемыми в качестве WebPart элементов управления). К этим методам относятся AddWebPart, , AuthorizeWebPart, CloseWebPartCopyWebPart, CreateWebPartDeleteWebPart, DisconnectWebPart, BeginWebPartEditing, , EndWebPartEditing, , ExportWebPart, ImportWebPartGetGenericWebPart, IsAuthorizedи .MoveWebPart
Другой набор методов предназначен для подключений. Сюда входят такие методы, как ActivateConnections, BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPart, DisconnectWebParts, EndWebPartConnectingи GetProviderConnectionPointsGetConsumerConnectionPoints.
Наконец, некоторые WebPartManager методы ориентированы на функциональность персонализации. К ним относятся CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save и SaveControlState.
Дополнительные сведения о других методах WebPartManager , доступных Internals через свойство , см. в документации по классу WebPartManagerInternals .
Примечания для тех, кто наследует этот метод
Элемент WebPartManager управления предназначен для расширения. Так как он занимает центральное место в приложениях веб-частей, если требуется расширить определенный тип или элемент управления в наборе элементов управления веб-частей, во многих случаях также необходимо расширить WebPartManager класс, так как он, скорее всего, будет иметь некоторое свойство или метод, необходимый для обеспечения работы пользовательского типа в контексте приложения веб-частей. В справочной документации по веб-частям (см. System.Web.UI.WebControls.WebParts) при обсуждении расширения типа веб-частей часто упоминается, что необходимо сделать для расширения WebPartManager класса, или показано, как расширить его в примере кода.
Конструкторы
| WebPartManager() |
Инициализирует новый экземпляр класса WebPartManager. |
Поля
| BrowseDisplayMode |
Представляет режим отображения по умолчанию для страниц, которые содержат элементы управления веб-частей. Это поле доступно только для чтения. |
| CatalogDisplayMode |
Представляет режим отображения, используемый для добавления серверных элементов управления из каталога элементов управления на веб-страницу. Это поле доступно только для чтения. |
| ConnectDisplayMode |
Представляет режим отображения, используемый для отображения специального пользовательского интерфейса для пользователей в целях управления подключениями между элементами управления WebPart. Это поле доступно только для чтения. |
| DesignDisplayMode |
Представляет режим отображения, используемый для изменения макета веб-страниц, содержащих элементы управления веб-частей. Это поле доступно только для чтения. |
| EditDisplayMode |
Представляет режим отображения, в котором конечные пользователи смогут изменять серверные элементы управления. Это поле доступно только для чтения. |
Свойства
| Adapter |
Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control) |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control) |
| AvailableTransformers |
Возвращает коллекцию объектов WebPartTransformer, которые доступны для использования при создании подключений веб-частей между серверными элементами управления. |
| BindingContainer |
Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control) |
| ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
| ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
| CloseProviderWarning |
Получает или задает предупреждение, которое отображается при закрытии пользователем элемента управления, функционирующего в качестве поставщика для других элементов управления в подключении. |
| Connections |
Возвращает ссылку на коллекцию текущих подключений на веб-странице. |
| Context |
Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
Возвращает коллекцию WebPart, серверных или пользовательских элементов управления, которые содержатся в зонах WebPartZoneBase на веб-странице и управляются элементом управления WebPartManager. |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control) |
| DeleteWarning |
Получает или задает пользовательское предупреждение, отображаемое для конечных пользователей, которые удаляют элемент управления. |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control) |
| DisplayMode |
Получает или задает активный режим отображения для веб-страницы, на которой содержатся элементы управления веб-частей. |
| DisplayModes |
Возвращает доступную только для чтения коллекцию всех режимов отображения, сопоставленных с элементом управления WebPartManager. |
| DynamicConnections |
Возвращает коллекцию всех динамических подключений, которые в настоящее время существуют на веб-странице. |
| EnableClientScript |
Получает или задает значение, которое определяет, включено ли создание скриптов на стороне клиента для веб-странице, на которой содержится элемент управления WebPartManager. |
| EnableTheming |
Возвращает значение, которое указывает, что использование тем на веб-странице включено. |
| EnableViewState |
Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| ExportSensitiveDataWarning |
Получает или задает текст предупреждения, которое отображается при попытке пользователем экспортировать конфиденциальные данные состояния из элемента управления WebPart. |
| HasChildViewState |
Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control) |
| ID |
Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control) |
| Internals |
Возвращает ссылку на класс WebPartManagerInternals, который используется для объединения и отделения набора методов, которые фактически реализованы в классе WebPartManager, но предназначены преимущественно для разработчиков элементов управления. |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control) |
| IsCustomPersonalizationStateDirty |
Возвращает значение, которое указывает, были ли сделаны изменения персонализации, затронувшие персонализацию на уровне страницы, управляемой элементом управления WebPartManager. |
| IsTrackingViewState |
Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control) |
| IsViewStateEnabled |
Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control) |
| MediumPermissionSet |
Получает объект PermissionSet, допускающий только разрешение Execution и разрешение Medium. |
| MinimalPermissionSet |
Получает объект PermissionSet, допускающий только разрешение Execution и разрешение Minimal. |
| NamingContainer |
Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control) |
| Page |
Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control) |
| Parent |
Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control) |
| Personalization |
Возвращает ссылку на объект, который содержит данные персонализации для веб-страницы. |
| RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
| SelectedWebPart |
Возвращает ссылку на элемент управления WebPart или другой серверный элемент управления, который в настоящее время выбран для редактирования или для создания подключения к другому элементу управления. |
| Site |
Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Получает или задает пустую строку (""), чтобы к элементу управления WebPartManager можно было применить обложку. |
| StaticConnections |
Возвращает ссылку на коллекцию всех объектов WebPartConnection на веб-странице, которые определены как статические подключения. |
| SupportedDisplayModes |
Возвращает доступную только для чтения коллекцию всех режимов отображения, которые доступны на определенной веб-странице. |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| UniqueID |
Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control) |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control) |
| Visible |
Возвращает значение, которое делает видимыми дочерними элементы управления. |
| WebParts |
Возвращает ссылку на все элементы управления WebPart, отслеживаемые элементом управления WebPartManager на веб-странице. |
| Zones |
Возвращает ссылку на коллекцию всех зон WebPartZoneBase на веб-странице. |
Методы
| ActivateConnections() |
Делает все неактивные подключения на веб-странице активными. |
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control) |
| AddWebPart(WebPart, WebPartZoneBase, Int32) |
Предоставляет стандартный программный метод для добавления элементов управления на веб-странице WebPart. |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| BeginWebPartConnecting(WebPart) |
Запускает подключение двух элементов управления WebPart друг к другу. |
| BeginWebPartEditing(WebPart) |
Запускает редактирование элемента управления WebPart. |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
| CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) |
Проверяет элементы управления WebPart, которые будут участвовать в подключении, для определения, способны ли они подключаться друг к другу, если элементы управления поставщика и получателя имеют совместимые интерфейсы, а объект WebPartTransformer не требуется. |
| CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) |
Проверяет элементы управления WebPart, которые будут участвовать в подключении, для определения, смогут ли они подключаться, а также использует объект WebPartTransformer для создания подключения между несовместимыми поставщиками и получателями. |
| CheckRenderClientScript() |
Проверяет возможности браузера, делающего запрос, а также значение свойства EnableClientScript для определения необходимости обработки клиентского скрипта. |
| ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control) |
| CloseWebPart(WebPart) |
Закройте элемент управления WebPart таким образом, чтобы он больше не отображался на веб-странице, но мог быть повторно открыт. |
| ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) |
Создает подключение между двумя элементами управления WebPart или GenericWebPart с использованием только ссылок на элементы управления и их определенные объекты ConnectionPoint. |
| ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) |
Создает подключение между двумя элементами управления WebPart или GenericWebPart с использованием только ссылок на элементы управления и их определенные объекты ConnectionPoint, а также объект WebPartTransformer. |
| CopyWebPart(WebPart) |
Используется набором элементов управления веб-частей для создания копии WebPart или серверного элемента управления для добавления элемента управления на веб-страницу. |
| CreateAvailableTransformers() |
Создает набор преобразователей, указанный в файле конфигурации веб-сайта, и добавляет эти преобразователи в коллекцию преобразователей, на которую ссылается свойство AvailableTransformers. |
| CreateChildControls() |
Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки. (Унаследовано от Control) |
| CreateControlCollection() |
Возвращает коллекцию всех элементов управления, которые управляются на веб-странице с помощью элемента управления WebPartManager. Этот класс не наследуется. |
| CreateDisplayModes() |
Создает набор всех возможных режимов отображения для приложения веб-частей. |
| CreateDynamicConnectionID() |
Возвращает уникальное значение, которое будет служить в качестве идентификатора для динамического подключения. |
| CreateDynamicWebPartID(Type) |
Создает уникальные идентификатор для динамического элемента управления WebPart. |
| CreateErrorWebPart(String, String, String, String, String) |
Создает специальный элемент управления, который вставляется на страницу и отображается для конечных пользователей при завершении со сбоем попытки загрузки или создания динамического элемента управления WebPart по какой-либо причине. |
| CreatePersonalization() |
Возвращает объект персонализации, который должен содержать пользовательские данные персонализации для текущей веб-страницы. |
| CreateWebPart(Control) |
Помещает серверный элемент управления, который не является элементом управления WebPart, в оболочку из объекта GenericWebPart, чтобы этот элемент управления имел функциональные возможности веб-частей. |
| DataBind() |
Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления. (Унаследовано от Control) |
| DataBind(Boolean) |
Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control) |
| DeleteWebPart(WebPart) |
Окончательно удаляет динамический экземпляр элемента управления WebPart с веб-страницы. |
| DisconnectWebPart(WebPart) |
Удаляет WebPart или серверный элемент управления, который закрывается или удаляется из любого подключения, в котором принимал участие. |
| DisconnectWebParts(WebPartConnection) |
Выполняет отключение серверных элементов управления, которые подключены на веб-странице. |
| Dispose() |
Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| EndWebPartConnecting() |
Завершает процесс подключения элемента управления WebPart к другому элементу управления. |
| EndWebPartEditing() |
Завершает редактирование элемента управления WebPart. |
| EnsureChildControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control) |
| EnsureID() |
Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| ExportWebPart(WebPart, XmlWriter) |
Создает XML-файл описания, который содержит состояние и данные свойства для серверного элемента управления. |
| FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
| FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
| Focus() |
Переопределен для предотвращения перевода фокуса на элемент управления WebPartManager, так как для последнего отсутствует пользовательский интерфейс. |
| GetConsumerConnectionPoints(WebPart) |
Получает коллекцию объектов ConsumerConnectionPoint, которые могут функционировать в качестве точек подключения серверного элемента управления, выполняющего роль получателя в подключении веб-частей. |
| GetCurrentWebPartManager(Page) |
Получает ссылку на текущий экземпляр элемента управления WebPartManager на странице. |
| GetDesignModeState() |
Возвращает данные времени разработки для элемента управления. (Унаследовано от Control) |
| GetDisplayTitle(WebPart) |
Возвращает строку, содержащую значение для свойства DisplayTitle элемента управления WebPart. |
| GetExportUrl(WebPart) |
Возвращает относительный виртуальный путь и строку запроса, которые являются частью запроса, если пользователь пытается экспортировать элемент управления WebPart. |
| GetGenericWebPart(Control) |
Возвращает ссылку на экземпляр элемента управления GenericWebPart, содержащий серверный элемент управления. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetProviderConnectionPoints(WebPart) |
Получает коллекцию объектов ProviderConnectionPoint, которые могут функционировать в качестве точек подключения серверного элемента управления, выполняющего роль поставщика в подключении веб-частей. |
| 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) |
| ImportWebPart(XmlReader, String) |
Импортирует XML-файл описания, который содержит данные состояния и свойств для элемента управления WebPart и применяет эти данные к элементу управления. |
| IsAuthorized(Type, String, String, Boolean) |
Выполняет завершающие действия по определению, авторизован ли элемент управления для добавления на страницу. |
| IsAuthorized(WebPart) |
Выполняет начальные действия по определению, авторизован ли элемент управления для добавления на страницу. |
| IsLiteralContent() |
Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control) |
| LoadControlState(Object) |
Загружает данные состояния элемента управления, которые были сохранены после предыдущего запроса страницы и должны быть восстановлены в последующем запросе. |
| LoadCustomPersonalizationState(PersonalizationDictionary) |
Сохраняет пользовательские данные персонализации, переданные объектами персонализации в элемент управления WebPartManager для использования в будущем процессе инициализации. |
| LoadViewState(Object) |
Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState(). (Унаследовано от Control) |
| MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MoveWebPart(WebPart, WebPartZoneBase, Int32) |
Перемещает объект WebPart или серверный элемент управления из одной зоны WebPartZoneBase в другую или в новую позицию в той же зоне. |
| OnAuthorizeWebPart(WebPartAuthorizationEventArgs) |
Создает событие AuthorizeWebPart и вызывает обработчик для этого события, если таковой существует. |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnConnectionsActivated(EventArgs) |
Создает событие ConnectionsActivated для указания загрузки страницы и ее элементов управления, а также активации подключений на странице, что означает готовность к началу совместного использования данных. |
| OnConnectionsActivating(EventArgs) |
Создает событие ConnectionsActivating для указания загрузки страницы и ее элементов управления, а также возможности активации подключений. |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnDisplayModeChanged(WebPartDisplayModeEventArgs) |
Создает событие DisplayModeChanged для указания того, что элемент управления WebPartManager завершил переключение на веб-странице из одного режима отображения в другой. |
| OnDisplayModeChanging(WebPartDisplayModeCancelEventArgs) |
Создает событие DisplayModeChanging для указания того, что элемент управления WebPartManager находится в процессе переключения из одного режима отображения в другой. |
| OnInit(EventArgs) |
Создает событие Init, которое является первым событием в жизненном цикле элемента управления WebPartManager. |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnPreRender(EventArgs) |
Создает событие PreRender, которое происходит перед визуализацией элемента управления WebPartManager на веб-странице. |
| OnSelectedWebPartChanged(WebPartEventArgs) |
Создает событие SelectedWebPartChanged, которое происходит после выбора элемента управления WebPart или отмены выбора этого элемента управления. |
| OnSelectedWebPartChanging(WebPartCancelEventArgs) |
Создает событие SelectedWebPartChanging, которое происходит во время изменения текущего выбора элементов управления WebPart. |
| OnUnload(EventArgs) |
Создает базовое событие Unload и удаляет экземпляр WebPartManager с веб-страницы. |
| OnWebPartAdded(WebPartEventArgs) |
Создает событие WebPartAdded, которое происходит после добавления на страницу элемента управления WebPart. |
| OnWebPartAdding(WebPartAddingEventArgs) |
Создает событие WebPartAdding, которое происходит во время процесса добавления элемента управления WebPart (или серверного, или пользовательского элемента управления) в зону WebPartZoneBase. |
| OnWebPartClosed(WebPartEventArgs) |
Создает событие WebPartClosed для оповещение об удалении элемента управления со страницы. |
| OnWebPartClosing(WebPartCancelEventArgs) |
Создает событие WebPartClosing, которое происходит во время удаления со страницы серверного элемента управления или объекта WebPart. |
| OnWebPartDeleted(WebPartEventArgs) |
Создает событие WebPartDeleted, которое происходит после окончательного удаления со страницы элемента управления WebPart. |
| OnWebPartDeleting(WebPartCancelEventArgs) |
Создает событие WebPartDeleting, которое указывает, что динамический элемент управления WebPart (или серверный, или пользовательский элемент управления, содержащийся в зоне WebPartZoneBase) находится в процессе удаления. |
| OnWebPartMoved(WebPartEventArgs) |
Создает событие WebPartMoved, которое происходит после перемещения элемента управления WebPart в другое место на странице. |
| OnWebPartMoving(WebPartMovingEventArgs) |
Создает событие WebPartMoving, которое указывает, что WebPart или серверный, или пользовательский элемент управления в зоне WebPartZoneBase находится в процессе перемещения. |
| OnWebPartsConnected(WebPartConnectionsEventArgs) |
Создает событие WebPartsConnected, которое происходит после установки подключения между элементами управления WebPart. |
| OnWebPartsConnecting(WebPartConnectionsCancelEventArgs) |
Создает событие WebPartsConnecting, которое происходит во время установки подключения между двумя WebPart или серверными, или пользовательскими элементами управления, содержащимися в зоне WebPartZoneBase. |
| OnWebPartsDisconnected(WebPartConnectionsEventArgs) |
Создает событие WebPartsDisconnected, которое происходит после завершения подключения между элементами управления WebPart. |
| OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs) |
Создает событие WebPartsDisconnecting, которое указывает, что два объекта WebPart или серверных, или пользовательских элементов управления в зоне WebPartZoneBase находятся в процессе завершения подключения. |
| OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
| RegisterClientScript() |
Разрешает элементу управления WebPartManager запустить скрипт на стороне клиента, который используется для различных функциональных возможностей персонализации, таких как перетаскивание элементов управления WebPart на веб-странице. |
| RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Переопределен, чтобы не дать элементу управления WebPartManager отрисовать какое-либо содержимое. |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
| ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет данные состояния для элемента управления WebPartManager, так что данные могут быть восстановлены при будущих запросах веб-страницы, содержащей элемент управления. |
| SaveCustomPersonalizationState(PersonalizationDictionary) |
Сохраняет данные состояния пользовательской персонализации, поддерживаемые элементом управления WebPartManager, чтобы эти данные могли быть повторно загружены при повторной загрузке страницы. |
| SaveViewState() |
Сохраняет любые изменения состояния просмотра серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
| SetPersonalizationDirty() |
Задает флаг, указывающий, что пользовательские данные персонализации для элемента управления WebPartManager были изменены. |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
| SetSelectedWebPart(WebPart) |
Задает значение свойства SelectedWebPart равным выбранному в настоящий момент WebPart или серверному элементу управления. |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Применяет данные состояния персонализации к элементу управления WebPartManager и вызывает базовый метод для разрешения отслеживания изменений данных состояния просмотра для этого элемента управления. |
События
| AuthorizeWebPart |
Происходит при вызове метода IsAuthorized для определения, можно ли добавить на страницу объект WebPart или серверный элемент управления. |
| ConnectionsActivated |
Происходит после того, как все текущие подключения веб-частей на странице не только будут подключены, но и начнут активно обмениваться данными между элементами управления поставщиков и получателей в каждом подключении. |
| ConnectionsActivating |
Происходит во время активации всех установленных подключений веб-частей на веб-странице. |
| DataBinding |
Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control) |
| DisplayModeChanged |
Происходит после изменения текущего режима отображения на странице веб-частей. |
| DisplayModeChanging |
Происходит после щелчка пользователем команды на веб-странице, которая запускает процесс переключения в другой режим отображения. |
| Disposed |
Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control) |
| Init |
Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control) |
| Load |
Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control) |
| PreRender |
Происходит после загрузки объекта Control, но перед отрисовкой. (Унаследовано от Control) |
| SelectedWebPartChanged |
Происходит после изменение и перемещения выбранного элемента управления WebPart в другой элемент управления на веб-странице. |
| SelectedWebPartChanging |
Происходит во время изменения текущего выбора на странице элемента управления WebPart или серверного элемента управления. |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
| WebPartAdded |
Происходит после добавления динамического или другого элемента управления WebPart в зону WebPartZoneBase для указания успешного добавления элемента управления. |
| WebPartAdding |
Происходит во время процесса добавления динамического WebPart или другого серверного элемента управления в зону WebPartZoneBase. |
| WebPartClosed |
Происходит при удалении со страницы элемента управления WebPart (или серверный, или пользовательский элемент управления). |
| WebPartClosing |
Происходит во время удаления элемента управления WebPart control (или серверного, или пользовательского элемента управления) со страницы. |
| WebPartDeleted |
Происходит после удаления элемента управления WebPart или другого серверного элемента управления из зоны WebPartZoneBase. |
| WebPartDeleting |
Происходит во время процесса окончательного удаления экземпляра динамического WebPart или другого серверного элемента управления из зоны WebPartZoneBase. |
| WebPartMoved |
Происходит после перемещения в другое место веб-страницы элемента управления WebPart или серверного элемента управления. |
| WebPartMoving |
Происходит во время процесса перемещения WebPart или другого серверного элемента, содержащегося в зоне WebPartZoneBase. |
| WebPartsConnected |
Происходит после установки определенного подключения между элементами управления WebPart (или серверными, или пользовательскими элементами управления). |
| WebPartsConnecting |
Происходит во время процесса создания подключения между элементами управления WebPart (или серверными, или пользовательскими элементами управления, размещенными в зоне WebPartZoneBase). |
| WebPartsDisconnected |
Происходит после разрыва подключения между двумя элементами управления WebPart или серверными элементами управления. |
| WebPartsDisconnecting |
Происходит во время процесса завершения подключения между ранее подключенными WebPart или серверными элементами управления. |
Явные реализации интерфейса
| 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) |
| IPersonalizable.IsDirty |
Возвращает значение, которое указывает, были ли изменены на веб-страницы данные состояния персонализации, управляемые элементом управления WebPartManager. |
| IPersonalizable.Load(PersonalizationDictionary) |
Возвращает сохраненные данные о состоянии пользовательской персонализации, которые требуется загрузить в элемент управления WebPartManager. |
| IPersonalizable.Save(PersonalizationDictionary) |
Сохраняет пользовательские данные состояния персонализации, которые управляются элементом управления WebPartManager. |
Методы расширения
| 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.
Отправить и просмотреть отзыв по