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 IPersonalizable
Public Class WebPartManager
Inherits Control
Implements INamingContainer, IPersonalizable
Наследование
WebPartManager
Атрибуты
Реализации

Примеры

В следующем примере кода демонстрируется декларативное и программное использование 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> элемент для создания соединений между элементами управления. В режиме подключения щелкните стрелку вниз в строке заголовка элемента управления ZIP Code, чтобы активировать меню команд, а затем щелкните Подключение. После отображения пользовательского интерфейса подключения щелкните ссылку "Создать подключение к потребителю ". Появится ячейка с раскрывающимся списком. Выберите weather Control в раскрывающемся списке и нажмите кнопку Подключение, чтобы завершить подключение двух элементов управления. Нажмите кнопку "Закрыть", а затем используйте раскрывающийся список "Режим отображения ", чтобы вернуть страницу в обычный режим просмотра. Вы можете ввести ПОЧТОВЫй индекс, и элемент управления потребителем будет обновлен со значением, которое вы вводите. ZipCode Так как свойство было отмечено атрибутом Personalizable в исходном коде, это значение свойства будет сохраняться в сеансах браузера, тем самым сохраняя значение, введенное пользователем. Более сложный элемент управления потребителем может принимать сведения о почтовом индексе, искать информацию о погоде на основе кода и отображать ее пользователю.

Комментарии

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

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

Категория задач Что делает элемент управления
Отслеживание элементов управления веб-части Отслеживает множество различных типов элементов управления на странице, которые предоставляют веб-части функции, включая WebPart элементы управления, подключения, зоны и другие.
Добавление и удаление элементов управления веб-части Предоставляет методы для добавления, удаления и закрытия WebPart элементов управления на странице.
Администрирование подключений Создает соединения между элементами управления и отслеживает подключения, а также процессы их добавления и удаления.
Персонализация элементов управления и страниц Позволяет пользователям перемещать элементы управления в разные расположения на странице и запускать представления, в которых пользователи могут изменять внешний вид, свойства и поведение элементов управления. Поддерживает параметры персонализации для конкретных пользователей на каждой странице.
Переключение между различными представлениями страниц Переключает страницу между различными специализированными представлениями страницы, чтобы пользователи могли выполнять определенные задачи, такие как изменение макета страницы или редактирование элементов управления.
Создание событий жизненного цикла веб-части Определяет, вызывает и позволяет разработчикам обрабатывать события жизненного цикла элементов управления веб-части, например при добавлении, перемещении, подключении или удалении элементов управления.
Включение импорта и экспорта элементов управления Экспортирует XML-потоки, содержащие состояние свойств WebPart элементов управления, и позволяет пользователям импортировать файлы для удобства при персонализации сложных элементов управления на других страницах или сайтах.

Класс WebPartManager имеет большой набор свойств. В соответствии с WebPartManager ролью отслеживания других элементов управления он имеет ряд свойств, которые ссылаются на коллекции элементов управления веб-части или других специальных объектов веб-части. Свойства AvailableTransformers, Connections, ControlsSupportedDisplayModesDynamicConnectionsWebPartsDisplayModesи Zones все коллекции, используемые элементом WebPartManager управления для отслеживания и других задач управления.

Другая группа свойств содержит настраиваемые предупреждения, которые применяются в определенных сценариях, происходящих в приложении веб-части. К ним относятся CloseProviderWarningсвойства, DeleteWarningсвойства и свойства ExportSensitiveDataWarning .

Класс WebPartManager переопределяет некоторые из его базовых унаследованных свойств, которые используются многими элементами управления веб-сервера. К ним относятся свойства, SkinIDа Visible также EnableThemingсвойства.

Наконец, существует группа свойств, полезная для доступа к текущему состоянию приложения. Свойство 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, CreateWebPart, DeleteWebPart, DisconnectWebPart, EndWebPartEditingGetGenericWebPartExportWebPartImportWebPartBeginWebPartEditingIsAuthorizedа также .MoveWebPart

Другой набор методов предназначен для соединений. Сюда входят такие методы, как ActivateConnections, , BeginWebPartConnecting, DisconnectWebPartEndWebPartConnectingConnectWebPartsGetProviderConnectionPointsCanConnectWebPartsCreateAvailableTransformersDisconnectWebPartsGetConsumerConnectionPointsа также .

Наконец, некоторые 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)

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

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

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