WebPartManager Класс

Ссылка

Определение

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

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

Важно!

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

Служит в качестве центрального класса набора элементов управления веб-частей, управляющего всеми элементами управления веб-частей, функциональностью и событиями, происходящими на веб-странице.

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 IPersonalizable

Public Class WebPartManager
Inherits Control
Implements INamingContainer, IPersonalizable

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

Control
WebPartManager

Атрибуты: BindableAttribute

Реализации: 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, CloseWebPart CopyWebPart, CreateWebPart DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, , EndWebPartEditing, , ExportWebPart, ImportWebPart GetGenericWebPart, IsAuthorizedи .MoveWebPart

Другой набор методов предназначен для подключений. Сюда входят такие методы, как ActivateConnections, BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPart, DisconnectWebParts, EndWebPartConnectingи GetProviderConnectionPoints GetConsumerConnectionPoints.

Наконец, некоторые 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 значение `null`. (Унаследовано от Control)
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)	Выполняет поиск серверного элемента управления с заданным параметром `id` в текущем контейнере именования. (Унаследовано от Control)
FindControl(String, Int32)	Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным `id` и целым числом, указанным в параметре `pathOffset`, который содействует поиску. Эту версию метода FindControl не следует переопределять. (Унаследовано от Control)
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)	Включает поведение платформы динамических данных для указанного элемента управления данными.

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

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