WebPartManager WebPartManager WebPartManager WebPartManager Class

Определение

Служит в качестве центрального класса в наборе элементов управления веб-частей, контролируя работу всех элементов управления веб-частей, функциональность и события, происходящие на веб-странице.Serves as the central class of the Web Parts control set, managing all the Web Parts controls, functionality, and events that occur on a Web page.

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

Примеры

В следующем примере кода показано декларативное и программное использование WebPartManager элемента управления.The following code example demonstrates both declarative and programmatic use of the WebPartManager control.

Пример кода состоит из четырех частей:The code example has four parts:

  • Пользовательский элемент управления, позволяющий изменять режимы экрана на веб-части странице.A user control that enables you to change display modes on a Web Parts page.

  • Веб-страница, содержащая два настраиваемых WebPart элемента управления, которые могут быть подключены, <asp:webpartmanager> и элемент.A Web page that contains two custom WebPart controls that can be connected, and an <asp:webpartmanager> element.

  • Файл исходного кода, содержащий два пользовательских WebPart элемента управления и пользовательский интерфейс.A source code file that contains two custom WebPart controls, and a custom interface.

  • Описание работы примера в браузере.An explanation of how the example works in a browser.

Пользовательский элемент управления имеет раскрывающийся список, который показывает возможные режимы отображения на странице с учетом элементов управления веб-части, имеющихся на странице.The user control has a drop-down list control that shows the possible display modes on a page, given the Web Parts controls that are present on the page. На веб-странице этого примера кода этот пользовательский элемент управления объявлен непосредственно под WebPartManager элементом в разметке страницы, а Register в верхней части веб-страницы есть директива для регистрации элемента управления.In the Web page for this code example, this user control is declared just below the WebPartManager element in the page's markup, and there is a Register directive near the top of the Web page to register the control. Дополнительные сведения о режимах вывода и описание исходного кода в этом элементе управления см. в разделе Пошаговое руководство. Изменение режима экрана на веб-части странице.For details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ 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="&nbsp;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="&nbsp;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 содержит директивы как для пользовательского элемента управления, так и для пользовательских элементов управления.The declarative markup for the Web page contains Register directives for both the user control and the custom controls. Существует элемент, элемент для хранения пользовательских элементов управления и <asp:connectionszone> элемент. <asp:webpartzone> <asp:webpartmanager>There is an <asp:webpartmanager> element, an <asp:webpartzone> element to contain the custom controls, and an <asp:connectionszone> element. На этой странице также содержится встроенный код, который обрабатывает связанные с подключением события для WebPartManager элемента управления. результат этого кода можно увидеть в процессе подключения и отключения элементов управления.The page also contains some inline code that handles connection-related events for the WebPartManager control; you can see the effect of this code as you connect and disconnect controls.

<%@ 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>

В третьей части примера приведен исходный код для элементов управления.The third part of the example is the source code for the controls. Обратите внимание, что имеется интерфейс IZipCodeс именем, а этот интерфейс реализован ZipCodeWebPart в классе.Note that there is an interface named IZipCode, and this interface is implemented in the ZipCodeWebPart class. Этот класс имеет специальный метод обратного вызова ProvideIZipCode с именем, который служит поставщиком.This class has a special callback method named ProvideIZipCode that serves as a provider. Другой тип с именем WeatherWebPartтакже реализуется с помощью специального метода с именем GetIZipCode, который позволяет элементу управления действовать как потребитель другого элемента управления.The other type, named WeatherWebPart, is also implemented with a special method named GetIZipCode, which enables the control to act as a consumer of the other control.

Для выполнения примера кода необходимо скомпилировать этот исходный код.For the code example to run, you must compile this source code. Его можно скомпилировать явным образом и разместить полученную сборку в папке Bin веб-сайта или в глобальном кэше сборок.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Кроме того, можно разместить исходный код в папке App_Code сайта, где он будет динамически компилироваться во время выполнения.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. В этом примере кода предполагается, что источник был скомпилирован в сборку, а Register директива на веб-странице ссылается на имя сборки.This code example assumes that you have compiled the source into an assembly, and the Register directive in the Web page references the assembly name. Пошаговое руководство, в котором демонстрируется компиляция , см. в разделе Пошаговое руководство. Разработка и использование пользовательского серверного веб-элемента управления.For a walkthrough that demonstrates how to compile, see Walkthrough: Developing and Using a Custom Web Server Control.

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

После загрузки веб-страницы в браузере щелкните раскрывающийся список режим экрана и выберите подключить , чтобы переключить страницу в режим подключения.After you have loaded the Web page in a browser, click the Display Mode drop-down list control and select Connect to switch the page to connect mode. Режим подключения использует <asp:connectionszone> элемент, чтобы позволить создавать соединения между элементами управления.Connect mode uses the <asp:connectionszone> element to enable you to create connections between controls. В режиме подключения щелкните стрелку вниз в заголовке окна элемента управления " почтовый индекс ", чтобы активировать его меню команд, а затем нажмите кнопку подключить.In connect mode, click the downward arrow in the title bar of the ZIP Code control to activate its verbs menu, and then click Connect. После отображения пользовательского интерфейса подключения щелкните ссылку создать соединение с потребителем .After the connection UI appears, click the Create a connection to a Consumer link. Появится ячейка с элементом управления "раскрывающийся список".A cell appears that has a drop-down list control. Выберите элемент управления Weather в раскрывающемся списке и нажмите кнопку Подключиться , чтобы завершить подключение двух элементов управления.Select Weather Control in the drop-down list, and then click Connect to complete the connection of the two controls. Нажмите кнопку Закрыть, а затем используйте раскрывающийся список режим отображения , чтобы вернуть страницу в нормальный режим просмотра.Click Close, and then use the Display Mode drop-down list to return the page to normal browse mode. Можно ввести почтовый индекс, и элемент управления потребителя будет обновлен с введенным значением.You can enter a ZIP Code, and the consumer control will be updated with the value you enter. Personalizable Так как ZipCode свойство было помечено атрибутом в исходном коде, это значение свойства будет сохраняться в сеансах браузера, тем самым сохраняя значение, указанное пользователем.Because the ZipCode property was marked with the Personalizable attribute in the source code, this property value will persist across browser sessions, thus saving the value entered by a user. Более сложный элемент управления получателя может получить информацию о почтовом индексе, найти сведения о погоде на основе кода и отобразить их для пользователя.A more sophisticated consumer control could take the ZIP code information, look up weather information based on the code, and display it to a user.

Комментарии

WebPartManager Элемент управления выступает в качестве центра управления веб-части приложения.The WebPartManager control acts as the hub or control center of a Web Parts application. На каждой странице, использующей веб-части элементов управления, долженWebPartManager быть один и только один экземпляр элемента управления.There must be one--and only one--WebPartManager control instance on every page that uses Web Parts controls. Как и в большинстве аспектов веб-части приложений, WebPartManager элемент управления работает только с аутентифицированными пользователями.As with most aspects of Web Parts applications, the WebPartManager control works only with authenticated users. Кроме того, его функциональные возможности практически полностью работают с серверными элементами управления, которые находятся в зонах WebZone веб-части, которые наследуются от класса.Further, its functionality works almost entirely with server controls that reside within Web Parts zones that inherit from the WebZone class. Серверные элементы управления, расположенные на странице за пределами этих зон, могут иметь очень мало веб-части WebPartManager функциональности или взаимодействия с элементом управления.Server controls that reside on a page outside of these zones can have very little Web Parts functionality or interaction with the WebPartManager control.

В качестве центра для веб-частиной функциональности на странице WebPartManager элемент управления выполняет задачи, описанные в следующей таблице.As the hub for Web Parts functionality on a page, the WebPartManager control carries out the kinds of tasks described in the following table.

Категория задачиTask category Что делает элемент управленияWhat the control does
Отслеживание элементов управления веб-частиTracking Web Parts controls Отслеживает множество различных видов элементов управления на странице, которые предоставляют веб-части функции, включая WebPart элементы управления, подключения, зоны и т. д.Keeps track of the many different kinds of controls on a page that provide Web Parts features, including WebPart controls, connections, zones, and others.
Добавление и удаление элементов управления веб-частиAdding and removing Web Parts controls Предоставляет методы для добавления, удаления и закрытия WebPart элементов управления на странице.Provides the methods for adding, deleting, and closing WebPart controls on a page.
Администрирование подключенийAdministering connections Создает соединения между элементами управления и отслеживает подключения, а также процессы их добавления и удаления.Creates connections between controls, and monitors the connections as well as the processes of adding and removing them.
Персонализация элементов управления и страницPersonalizing controls and pages Позволяет пользователям перемещать элементы управления в разные места на странице и запускать представления, в которых пользователи могут изменять внешний вид, свойства и поведение элементов управления.Enables users to move controls to different locations on a page, and launches the views in which users can edit the appearance, properties, and behavior of controls. Поддерживает пользовательские параметры персонализации на каждой странице.Maintains user-specific personalization settings on each page.
Переключение между разными представлениями страницToggling between different page views Переключает страницу между различными специализированными представлениями страницы, чтобы пользователи могли выполнять определенные задачи, такие как изменение макета страницы или редактирование элементов управления.Switches a page among different specialized views of the page, so that users can carry out certain tasks such as changing page layout or editing controls.
Создание событий жизненного цикла веб-частиRaising Web Parts life-cycle events Определяет, создает и позволяет разработчикам управлять событиями жизненного цикла элементов управления веб-части, например при добавлении, перемещении, подключении или удалении элементов управления.Defines, raises, and enables developers to handle life-cycle events of Web Parts controls, such as when controls are being added, moved, connected, or deleted.
Включение импорта и экспорта элементов управленияEnabling import and export of controls Экспортирует XML-потоки, содержащие состояние свойств WebPart элементов управления, и позволяет пользователям импортировать файлы для удобства в персонализации сложных элементов управления на других страницах или сайтах.Exports XML streams that contain the state of the properties of WebPart controls, and allows users to import the files for convenience in personalizing complex controls in other pages or sites.

WebPartManager Класс имеет большой набор свойств.The WebPartManager class has a large set of properties. В соответствии с WebPartManager ролью отслеживания других элементов управления он имеет ряд свойств, которые ссылаются на коллекции либо веб-части элементов управления, либо других специальных объектов веб-части.Consistent with the WebPartManager role of tracking other controls, it has a number of properties that reference collections of either Web Parts controls, or other special Web Parts objects. Connections СвойстваWebPartManager ,, ,Controls ,,SupportedDisplayModes, иWebPartsявляются всеми коллекциями, используемыми элементом управления для отслеживания и других Zones DisplayModes AvailableTransformers DynamicConnections задачи управления.The AvailableTransformers, Connections, Controls, DisplayModes, DynamicConnections, SupportedDisplayModes, WebParts, and Zones properties are all collections used by the WebPartManager control for its tracking and other management tasks.

Другая группа свойств содержит настраиваемые предупреждения, которые применяются в определенных сценариях, происходящих в веб-части приложении.Another group of properties contains customizable warnings that apply in certain scenarios that occur in a Web Parts application. К ним относятся CloseProviderWarning DeleteWarning ExportSensitiveDataWarning свойства, и.These include the CloseProviderWarning, the DeleteWarning, and the ExportSensitiveDataWarning properties.

WebPartManager Класс переопределяет некоторые из его базовых унаследованных свойств, которые используются многими серверными веб-элементами управления.The WebPartManager class overrides some of its base inherited properties, which are used by many Web server controls. К EnableThemingним относятся свойства SkinID, и Visible .These include the EnableTheming, SkinID, and Visible properties.

Наконец, существует группа свойств, полезных для доступа к текущему состоянию приложения.Finally, there is a group of properties useful for accessing the current state of the application. DisplayMode Свойство указывает текущий режим экрана, в котором находится страница.The DisplayMode property indicates the current display mode that a page is in. EnableClientScript Свойство указывает, разрешено ли элементу управления прорисовку клиентского скрипта, что уместно в ситуациях, когда у пользователей могут быть браузеры с разными возможностями или если сценарии отключены.The EnableClientScript property indicates whether a control is allowed to render client-side script, which is relevant in situations where users might have browsers with different capabilities or have scripting turned off. Internals Свойство полезно для ссылки на служебный класс, содержащий вызовы к ряду важных веб-части методов, используемых для вариантов расширения.The Internals property is useful for referencing a utility class that contains the calls to a number of important Web Parts methods that are used for extensibility cases. Скрывая вызовы этих методов в отдельном классе ( WebPartManagerInternals классе) WebPartManager , можно упростить собственный API класса.By hiding the calls to these methods in a separate class (the WebPartManagerInternals class), the WebPartManager class's own API is simplified. Personalization Свойство предоставляет доступ к объектам персонализации, которые хранят параметры персонализации пользователей и сохраняют эти данные в постоянном хранилище.The Personalization property provides access to the personalization objects that store users' personalization settings and persist that data to permanent storage. Свойство указывает, какой WebPart элемент управления на странице в данный момент выбран пользователем или приложением. SelectedWebPartThe SelectedWebPart property indicates which WebPart control on a page is currently selected by the user or the application. Свойство IPersonalizable.IsDirty указывает, изменились ли пользовательские данные персонализации WebPart в элементе управления.The IPersonalizable.IsDirty property indicates whether custom personalization data on a WebPart control has changed.

WebPartManager Элемент управления содержит пять встроенных режимов отображения или представления веб-страницы.The WebPartManager control contains five built-in display modes, or views of a Web page. Разработчики могут расширить эту функцию, создавая пользовательские режимы интерфейса, расширяя типы, такие WebZone как класс ToolZone или класс.Developers can extend this feature, creating custom display modes by extending types such as the WebZone class or the ToolZone class. Пользователи могут переключать страницу в различные режимы отображения при условии, что на странице имеются соответствующие типы элементов управления, соответствующие заданному режиму отображения.Users can switch a page into the various display modes, provided that the proper kind of controls that correspond to a given display mode are present on a page.

Примечание

Эту функцию можно расширить, чтобы пользователи могли переключиться в пользовательский режим экрана без соответствующей зоны на странице.It is possible to extend this feature so that users can switch into a custom display mode without having a corresponding zone on the page. Однако поведение по умолчанию заключается в том, что режимы экрана соответствуют зонам.However, the default behavior is that display modes correspond to zones.

Стандартные режимы интерфейса представлены открытыми полями WebPartManager класса.The standard display modes are represented by public fields in the WebPartManager class. В следующей таблице перечислены поля и режимы вывода, на которые они ссылаются.The following table summarizes the fields and the display modes they refer to. Текущий режим отображения страницы, как указано выше, всегда упоминается в DisplayMode свойстве, и набор режимов отображения, доступных на конкретной странице, с учетом типа зон, имеющихся на странице, содержится SupportedDisplayModes в свойстве.The current display mode of a page, as noted above, is always referenced in the DisplayMode property, and the set of display modes that is possible on a particular page, given the kind of zones that are present on the page, is contained in the SupportedDisplayModes property.

ПолеField Сведения о режиме просмотраDisplay mode details
BrowseDisplayMode Нормальное пользовательское представление веб-страницы; по умолчанию и наиболее распространенный режим вывода.The normal user view of a Web page; the default and most common display mode.
DesignDisplayMode Представление, в котором пользователи могут изменять или удалять элементы управления для изменения макета страницы.The view in which users can rearrange or delete controls to change the page layout.
EditDisplayMode Представление, в котором отображается пользовательский интерфейс редактирования; Пользователи могут изменять внешний вид, свойства и поведение элементов управления, видимых в нормальном режиме просмотра.The view in which an editing user interface (UI) becomes visible; users can edit the appearance, properties, and behavior of the controls that are visible in the normal browse mode.
CatalogDisplayMode Представление, в котором пользовательский интерфейс каталога станет видимым. Пользователи могут добавлять элементы управления на страницу из каталогов доступных элементов управления.The view in which a catalog UI becomes visible; users can add controls to a page from catalogs of available controls.
ConnectDisplayMode Представление, в котором отображается пользовательский интерфейс подключения; Пользователи могут подключаться, управлять и отключать соединения между элементами управления.The view in which a connection UI becomes visible; users can connect, manage, or disconnect connections between controls.

WebPartManager Элемент управления также содержит ряд событий, критических для жизненного цикла веб-части страниц и элементов управления.The WebPartManager control also contains a number of events that are critical in the life cycle of Web Parts pages and controls. Эти события обеспечивают точное программное управление поведением элементов управления веб-части.These events provide precise programmatic control over the behavior of Web Parts controls. Большинство методов относятся непосредственно к WebPart элементам управления (или другим серверным или пользовательским элементам управления WebPartZoneBase , размещаемым в зонах, чтобы WebPart они могли работать как элементы управления).Most methods pertain directly to WebPart controls (or other server or user controls that are placed in WebPartZoneBase zones so that they can behave as WebPart controls). Однако несколько событий относятся к состоянию страницы или соединениям на странице.However, a few events pertain to the state of the page or connections on the page. В следующей таблице перечислены доступные события и приведены их цели.The following table lists the available events and summarizes their purposes.

Примечание

Во всех случаях, приведенных в следующей таблице, слово «Control» означает WebPart элемент управления или любой серверный элемент управления, находящийся в зоне и заключенный в оболочку GenericWebPart с объектом во время выполнения.In all cases in the following table, the word "control" refers to a WebPart control or any server control that resides in a zone and is wrapped with a GenericWebPart object at run time.

событиеEvent ОписаниеDescription
AuthorizeWebPart Происходит непосредственно перед добавлением элемента управления на страницу, чтобы проверить его авторизацию.Occurs just before a control is added to a page to verify that it is authorized.
ConnectionsActivated Происходит после активации всех соединений на странице.Occurs after all the connections on a page have been activated.
ConnectionsActivating Происходит непосредственно перед процессом активации всех соединений на странице.Occurs just before the process of activating all the connections on a page.
DisplayModeChanged Происходит после изменения текущего режима экрана страницы.Occurs after the current display mode of a page has changed.
DisplayModeChanging Происходит непосредственно перед изменением режима просмотра страницы.Occurs just before the process of changing a page's display mode.
SelectedWebPartChanged Происходит после отмены выбора элемента управления.Occurs after the selection of a control has been canceled.
SelectedWebPartChanging Происходит непосредственно перед отменой выбора элемента управления.Occurs just before the process of canceling the selection of a control.
WebPartAdded Происходит после добавления элемента управления в зону.Occurs after a control has been added to a zone.
WebPartAdding Происходит непосредственно перед добавлением элемента управления в зону.Occurs just before the process of adding a control to a zone.
WebPartClosed Происходит после того, как элемент управления был закрыт (удален со страницы).Occurs after a control has been closed (removed from a page).
WebPartClosing Происходит непосредственно перед закрытием элемента управления.Occurs just before the process of closing a control.
WebPartDeleted Происходит после окончательного удаления экземпляра динамического элемента управления (созданного программным путем или добавленным из каталога).Occurs after an instance of a dynamic control (one that was created programmatically or added from a catalog) has been permanently deleted.
WebPartDeleting Происходит непосредственно перед удалением динамического элемента управления.Occurs just before the process of deleting a dynamic control.
WebPartMoved Происходит после перемещения элемента управления в зону или в другую зону.Occurs after a control has moved within its zone or to another zone.
WebPartMoving Происходит непосредственно перед процессом перемещения элемента управления.Occurs just before the process of moving a control.
WebPartsConnected Происходит после того, как два элемента управления, выбранные для участия в соединении, установили соединение.Occurs after two controls selected for participation in a connection have established the connection.
WebPartsConnecting Происходит непосредственно перед процессом соединения двух элементов управления.Occurs just before the process of connecting two controls.
WebPartsDisconnected Происходит после разъединения двух подключенных элементов управления.Occurs after two connected controls have been disconnected.
WebPartsDisconnecting Происходит непосредственно перед отключением двух элементов управления.Occurs just before the process of disconnecting two controls.

WebPartManager Элемент управления имеет множество методов для управления веб-части страницами.The WebPartManager control has numerous methods for managing Web Parts pages. Большой набор методов, не перечисленных здесь, — это методы, имена которых принимают форму OnEventName.A large set of the methods, not listed here, are methods whose names take the form of OnEventName. Эти методы обычно вызывают связанное событие и предоставляют событие с обработчиком типа WebPartEventHandler.These methods typically raise their associated event, and provide the event with a handler of type WebPartEventHandler. Большинство этих методов могут быть переопределены разработчиками, наследующими от WebPartManager класса.Most of these methods can be overridden by developers who inherit from the WebPartManager class. Кроме того, разработчики страниц могут предоставлять пользовательские обработчики для событий, связанных с этими методами.Also, page developers can provide custom handlers for the events associated with these methods. Например, в случае WebPartAdded события разработчик страницы может OnWebPartAdded добавить атрибут к <asp:webpartmanager> элементу в разметке веб-страницы, а затем присвоить атрибуту имя пользовательского метода, чтобы обеспечить пользовательскую обработку события.For example, in the case of the WebPartAdded event, a page developer could add an OnWebPartAdded attribute to the <asp:webpartmanager> element in the markup of a Web page, and then assign a custom method name to the attribute to provide custom handling for the event. Атрибут соответствует OnWebPartAdded методу, и этот базовый шаблон обработки событий работает для большинства веб-части событий и связанных с ними методов.The attribute corresponds to the OnWebPartAdded method, and this basic pattern of event handling works for most Web Parts events and their associated methods.

Кроме того WebPartManager , элемент управления обладает методами, определенными задачей WebPart управления элементами управления (а также серверными или пользовательскими WebPart элементами управления, используемыми в качестве элементов управления).In addition, the WebPartManager control has methods particular to the task of managing WebPart controls (and server or user controls used as WebPart controls). К AddWebPartэтим методам относятся CloseWebPart, CopyWebPart ,,,GetGenericWebPart, DeleteWebPart, ,,BeginWebPartEditing,, ,ImportWebPart, CreateWebPart DisconnectWebPart AuthorizeWebPart EndWebPartEditing ExportWebPart IsAuthorizedи .MoveWebPartThese methods include AddWebPart, AuthorizeWebPart, CloseWebPart, CopyWebPart, CreateWebPart, DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, EndWebPartEditing, ExportWebPart, GetGenericWebPart, ImportWebPart, IsAuthorized, and MoveWebPart.

Другой набор методов является специализированным для подключений.Another set of methods is specialized for connections. Сюда входят такие методы ActivateConnections CreateAvailableTransformers ConnectWebParts DisconnectWebPart ,какGetConsumerConnectionPoints, BeginWebPartConnecting, ,,DisconnectWebParts,, ,EndWebPartConnecting, и .GetProviderConnectionPoints CanConnectWebPartsThis includes methods such as ActivateConnections, BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPart, DisconnectWebParts, EndWebPartConnecting, GetConsumerConnectionPoints, and GetProviderConnectionPoints.

Наконец, некоторые WebPartManager методы сосредоточены на функциях персонализации.Finally, some WebPartManager methods focus on personalization functionality. К ним относятся CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save и SaveControlState.These include CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save, and SaveControlState.

Дополнительные сведения о других WebPartManager методах, доступных Internals через свойство, WebPartManagerInternals см. в документации по классу.For more information on other WebPartManager methods that are accessible through the Internals property, see the documentation for the WebPartManagerInternals class.

Примечания для тех, кто наследует этот метод

WebPartManager Элемент управления предназначен для расширения.The WebPartManager control is designed to be extended. Так как это центральное веб-части приложений, если требуется расширить некоторый определенный тип или элемент управления в наборе веб-части, во многих случаях необходимо также расширить WebPartManager класс, поскольку, скорее всего, у него есть некоторое свойство или метод, необходимые для выполнения Пользовательский тип работает в контексте веб-части приложения.Because it is so central to Web Parts applications, when you want to extend some specific type or control in the Web Parts control set, in many cases you must also extend the WebPartManager class, because it is likely to have some property or method that is required to make your custom type work in the context of a Web Parts application. Справочная документация по веб-части ( System.Web.UI.WebControls.WebPartsсм.). при обсуждении расширения типа веб-части часто упоминается, что необходимо сделать для WebPartManager расширения класса, или показано, как расширить его в примере кода.The Web Parts reference documentation (see System.Web.UI.WebControls.WebParts), when discussing how to extend a Web Parts type, frequently mentions what needs to be done to extend the WebPartManager class as well, or shows how to extend it in a code example.

Конструкторы

WebPartManager() WebPartManager() WebPartManager() WebPartManager()

Инициализирует новый экземпляр класса WebPartManager.Initializes a new instance of the WebPartManager class.

Поля

BrowseDisplayMode BrowseDisplayMode BrowseDisplayMode BrowseDisplayMode

Представляет режим отображения по умолчанию для страниц, которые содержат элементы управления веб-частей.Represents the default display mode for pages that contain Web Parts controls. Это поле доступно только для чтения.This field is read-only.

CatalogDisplayMode CatalogDisplayMode CatalogDisplayMode CatalogDisplayMode

Представляет режим отображения, используемый для добавления серверных элементов управления из каталога элементов управления на веб-страницу.Represents the display mode used for adding server controls from a catalog of controls to a Web page. Это поле доступно только для чтения.This field is read-only.

ConnectDisplayMode ConnectDisplayMode ConnectDisplayMode ConnectDisplayMode

Представляет режим отображения, используемый для отображения специального пользовательского интерфейса для пользователей в целях управления подключениями между элементами управления WebPart.Represents the display mode used for displaying a special user interface (UI) for users to manage connections between WebPart controls. Это поле доступно только для чтения.This field is read-only.

DesignDisplayMode DesignDisplayMode DesignDisplayMode DesignDisplayMode

Представляет режим отображения, используемый для изменения макета веб-страниц, содержащих элементы управления веб-частей.Represents the display mode used for changing the layout of Web pages that contain Web Parts controls. Это поле доступно только для чтения.This field is read-only.

EditDisplayMode EditDisplayMode EditDisplayMode EditDisplayMode

Представляет режим отображения, в котором конечные пользователи смогут изменять серверные элементы управления.Represents the display mode in which end users can edit and modify server controls. Это поле доступно только для чтения.This field is read-only.

Свойства

Adapter Adapter Adapter Adapter

Возвращает конкретный адаптер браузера для элемента управления.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
AvailableTransformers AvailableTransformers AvailableTransformers AvailableTransformers

Возвращает коллекцию объектов WebPartTransformer, которые доступны для использования при создании подключений веб-частей между серверными элементами управления.Gets a collection of WebPartTransformer objects that are available for use in creating Web Parts connections between server controls.

BindingContainer BindingContainer BindingContainer BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.Gets the control that contains this control's data binding.

(Inherited from Control)
ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Возвращает значение символа разделителя, используемого в свойстве ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
CloseProviderWarning CloseProviderWarning CloseProviderWarning CloseProviderWarning

Получает или задает предупреждение, которое отображается при закрытии пользователем элемента управления, функционирующего в качестве поставщика для других элементов управления в подключении.Gets or sets a warning that is displayed when a user closes a control that is acting as a provider to other controls in a connection.

Connections Connections Connections Connections

Возвращает ссылку на коллекцию текущих подключений на веб-странице.Gets a reference to the collection of all current connections on a Web page.

Context Context Context Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Возвращает коллекцию WebPart, серверных или пользовательских элементов управления, которые содержатся в зонах WebPartZoneBase на веб-странице и управляются элементом управления WebPartManager.Gets the collection of all WebPart, server, or user controls that are contained in WebPartZoneBase zones on a Web page and are managed by the WebPartManager control.

DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DeleteWarning DeleteWarning DeleteWarning DeleteWarning

Получает или задает пользовательское предупреждение, отображаемое для конечных пользователей, которые удаляют элемент управления.Gets or sets a custom warning message displayed to end users when they delete a control.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
DisplayMode DisplayMode DisplayMode DisplayMode

Получает или задает активный режим отображения для веб-страницы, на которой содержатся элементы управления веб-частей.Gets or sets the active display mode for a Web page that contains Web Parts controls.

DisplayModes DisplayModes DisplayModes DisplayModes

Возвращает доступную только для чтения коллекцию всех режимов отображения, сопоставленных с элементом управления WebPartManager.Gets a read-only collection of all display modes that are associated with a WebPartManager control.

DynamicConnections DynamicConnections DynamicConnections DynamicConnections

Возвращает коллекцию всех динамических подключений, которые в настоящее время существуют на веб-странице.Gets the collection of all dynamic connections that currently exist on a Web page.

EnableClientScript EnableClientScript EnableClientScript EnableClientScript

Получает или задает значение, которое определяет, включено ли создание скриптов на стороне клиента для веб-странице, на которой содержится элемент управления WebPartManager.Gets or sets a value that determines whether client-side scripting is enabled on the Web page that contains a WebPartManager control.

EnableTheming EnableTheming EnableTheming EnableTheming

Возвращает значение, которое указывает, что использование тем на веб-странице включено.Gets a value indicating that the use of themes is enabled on a Web page.

EnableViewState EnableViewState EnableViewState EnableViewState

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events Events Events Events

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

(Inherited from Control)
ExportSensitiveDataWarning ExportSensitiveDataWarning ExportSensitiveDataWarning ExportSensitiveDataWarning

Получает или задает текст предупреждения, которое отображается при попытке пользователем экспортировать конфиденциальные данные состояния из элемента управления WebPart.Gets or sets the text of a warning message that is displayed when a user attempts to export sensitive state data from a WebPart control.

HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

Описание этого члена см. в разделе UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
Internals Internals Internals Internals

Возвращает ссылку на класс WebPartManagerInternals, который используется для объединения и отделения набора методов, которые фактически реализованы в классе WebPartManager, но предназначены преимущественно для разработчиков элементов управления.Gets a reference to the WebPartManagerInternals class, which is used to combine and separate a set of methods that are actually implemented in the WebPartManager class, but are mostly useful for control developers.

IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsCustomPersonalizationStateDirty IsCustomPersonalizationStateDirty IsCustomPersonalizationStateDirty IsCustomPersonalizationStateDirty

Возвращает значение, которое указывает, были ли сделаны изменения персонализации, затронувшие персонализацию на уровне страницы, управляемой элементом управления WebPartManager.Gets a value that indicates whether personalization changes have been made that affect page-level personalization details controlled by the WebPartManager control.

IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
MediumPermissionSet MediumPermissionSet MediumPermissionSet MediumPermissionSet

Получает объект PermissionSet, допускающий только разрешение Execution и разрешение Medium.Gets a PermissionSet object that allows only Execution permission and Medium permission.

MinimalPermissionSet MinimalPermissionSet MinimalPermissionSet MinimalPermissionSet

Получает объект PermissionSet, допускающий только разрешение Execution и разрешение Minimal.Gets a PermissionSet object that allows only Execution permission and Minimal permission.

NamingContainer NamingContainer NamingContainer NamingContainer

Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Page Page Page Page

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
Personalization Personalization Personalization Personalization

Возвращает ссылку на объект, который содержит данные персонализации для веб-страницы.Gets a reference to an object that contains personalization data for a Web page.

RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
SelectedWebPart SelectedWebPart SelectedWebPart SelectedWebPart

Возвращает ссылку на элемент управления WebPart или другой серверный элемент управления, который в настоящее время выбран для редактирования или для создания подключения к другому элементу управления.Gets a reference to a WebPart or other server control that is currently selected for editing or for creating a connection with another control.

Site Site Site Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Получает или задает пустую строку (""), чтобы к элементу управления WebPartManager можно было применить обложку.Gets or sets an empty string ("") so that no skin can be applied to the WebPartManager control.

StaticConnections StaticConnections StaticConnections StaticConnections

Возвращает ссылку на коллекцию всех объектов WebPartConnection на веб-странице, которые определены как статические подключения.Gets a reference to the collection of all WebPartConnection objects on a Web page that are defined as static connections.

SupportedDisplayModes SupportedDisplayModes SupportedDisplayModes SupportedDisplayModes

Возвращает доступную только для чтения коллекцию всех режимов отображения, которые доступны на определенной веб-странице.Gets a read-only collection of all display modes that are available on a particular Web page.

TemplateControl TemplateControl TemplateControl TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
UniqueID UniqueID UniqueID UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ViewState ViewState ViewState ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Возвращает значение, которое делает видимыми дочерними элементы управления.Gets a value that enables child controls to be visible.

WebParts WebParts WebParts WebParts

Возвращает ссылку на все элементы управления WebPart, отслеживаемые элементом управления WebPartManager на веб-странице.Gets a reference to all WebPart controls tracked by the WebPartManager control on a Web page.

Zones Zones Zones Zones

Возвращает ссылку на коллекцию всех зон WebPartZoneBase на веб-странице.Gets a reference to a collection of all the WebPartZoneBase zones on a Web page.

Методы

ActivateConnections() ActivateConnections() ActivateConnections() ActivateConnections()

Делает все неактивные подключения на веб-странице активными.Makes active all connections on a Web page that are currently inactive.

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
AddWebPart(WebPart, WebPartZoneBase, Int32) AddWebPart(WebPart, WebPartZoneBase, Int32) AddWebPart(WebPart, WebPartZoneBase, Int32) AddWebPart(WebPart, WebPartZoneBase, Int32)

Предоставляет стандартный программный метод для добавления элементов управления на веб-странице WebPart.Provides the standard programmatic method for adding WebPart controls to a Web page.

ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

Запускает трассировку во время разработки данных отрисовки.Begins design-time tracing of rendering data.

(Inherited from Control)
BeginWebPartConnecting(WebPart) BeginWebPartConnecting(WebPart) BeginWebPartConnecting(WebPart) BeginWebPartConnecting(WebPart)

Запускает подключение двух элементов управления WebPart друг к другу.Starts the process of connecting two WebPart controls.

BeginWebPartEditing(WebPart) BeginWebPartEditing(WebPart) BeginWebPartEditing(WebPart) BeginWebPartEditing(WebPart)

Запускает редактирование элемента управления WebPart.Starts the process of editing a WebPart control.

BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Проверяет элементы управления WebPart, которые будут участвовать в подключении, для определения, способны ли они подключаться друг к другу, если элементы управления поставщика и получателя имеют совместимые интерфейсы, а объект WebPartTransformer не требуется.Checks the WebPart controls that will be participating in a connection to determine whether they are capable of being connected, when the consumer and provider controls have compatible interfaces and a WebPartTransformer object is not needed.

CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Проверяет элементы управления WebPart, которые будут участвовать в подключении, для определения, смогут ли они подключаться, а также использует объект WebPartTransformer для создания подключения между несовместимыми поставщиками и получателями.Checks the WebPart controls that will be participating in a connection to determine whether they are capable of being connected, and uses a WebPartTransformer object to create the connection between an incompatible consumer and provider.

CheckRenderClientScript() CheckRenderClientScript() CheckRenderClientScript() CheckRenderClientScript()

Проверяет возможности браузера, делающего запрос, а также значение свойства EnableClientScript для определения необходимости обработки клиентского скрипта.Checks the capabilities of the browser making the request, and the value of the EnableClientScript property, to determine whether to render client script.

ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

Задает для кэшированного свойства ClientID значение null.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CloseWebPart(WebPart) CloseWebPart(WebPart) CloseWebPart(WebPart) CloseWebPart(WebPart)

Закройте элемент управления WebPart таким образом, чтобы он больше не отображался на веб-странице, но мог быть повторно открыт.Closes a WebPart control in such a way that it is not rendered on a Web page, but can be reopened.

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Создает подключение между двумя элементами управления WebPart или GenericWebPart с использованием только ссылок на элементы управления и их определенные объекты ConnectionPoint.Creates a connection between two WebPart or GenericWebPart controls using only the references to the controls and their specified ConnectionPoint objects.

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Создает подключение между двумя элементами управления WebPart или GenericWebPart с использованием только ссылок на элементы управления и их определенные объекты ConnectionPoint, а также объект WebPartTransformer.Creates a connection between two WebPart or GenericWebPart controls using the references to the controls, their specified ConnectionPoint objects, and a WebPartTransformer object.

CopyWebPart(WebPart) CopyWebPart(WebPart) CopyWebPart(WebPart) CopyWebPart(WebPart)

Используется набором элементов управления веб-частей для создания копии WebPart или серверного элемента управления для добавления элемента управления на веб-страницу.Used by the Web Parts control set to create a copy of a WebPart or server control for the purpose of adding the control to a Web page.

CreateAvailableTransformers() CreateAvailableTransformers() CreateAvailableTransformers() CreateAvailableTransformers()

Создает набор преобразователей, указанный в файле конфигурации веб-сайта, и добавляет эти преобразователи в коллекцию преобразователей, на которую ссылается свойство AvailableTransformers.Creates a set of transformers specified in a Web site's configuration file and adds them to the collection of transformers referenced by the AvailableTransformers property.

CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Inherited from Control)
CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

Возвращает коллекцию всех элементов управления, которые управляются на веб-странице с помощью элемента управления WebPartManager.Returns the collection of all controls that are managed by the WebPartManager control on a Web page. Этот класс не наследуется.This class cannot be inherited.

CreateDisplayModes() CreateDisplayModes() CreateDisplayModes() CreateDisplayModes()

Создает набор всех возможных режимов отображения для приложения веб-частей.Creates the set of all possible display modes for a Web Parts application.

CreateDynamicConnectionID() CreateDynamicConnectionID() CreateDynamicConnectionID() CreateDynamicConnectionID()

Возвращает уникальное значение, которое будет служить в качестве идентификатора для динамического подключения.Gets a unique value to serve as an ID for a dynamic connection.

CreateDynamicWebPartID(Type) CreateDynamicWebPartID(Type) CreateDynamicWebPartID(Type) CreateDynamicWebPartID(Type)

Создает уникальные идентификатор для динамического элемента управления WebPart.Generates a unique ID for a dynamic WebPart control.

CreateErrorWebPart(String, String, String, String, String) CreateErrorWebPart(String, String, String, String, String) CreateErrorWebPart(String, String, String, String, String) CreateErrorWebPart(String, String, String, String, String)

Создает специальный элемент управления, который вставляется на страницу и отображается для конечных пользователей при завершении со сбоем попытки загрузки или создания динамического элемента управления WebPart по какой-либо причине.Creates a special control that is inserted into a page and displayed for end users, when an attempt to load or create a dynamic WebPart control fails for some reason.

CreatePersonalization() CreatePersonalization() CreatePersonalization() CreatePersonalization()

Возвращает объект персонализации, который должен содержать пользовательские данные персонализации для текущей веб-страницы.Returns a personalization object to contain a user's personalization data for the current Web page.

CreateWebPart(Control) CreateWebPart(Control) CreateWebPart(Control) CreateWebPart(Control)

Помещает серверный элемент управления, который не является элементом управления WebPart, в оболочку из объекта GenericWebPart, чтобы этот элемент управления имел функциональные возможности веб-частей.Wraps a server control that is not a WebPart control with a GenericWebPart object, so that the control can have Web Parts functionality.

DataBind() DataBind() DataBind() DataBind()

Связывает источник данных с вызывающим серверным элементом управления и всеми его дочерними элементами управления.Binds a data source to the invoked server control and all its child controls.

(Inherited from Control)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

Привязывает источник данных к дочерним элементам управления серверного элемента управления.Binds a data source to the server control's child controls.

(Inherited from Control)
DeleteWebPart(WebPart) DeleteWebPart(WebPart) DeleteWebPart(WebPart) DeleteWebPart(WebPart)

Окончательно удаляет динамический экземпляр элемента управления WebPart с веб-страницы.Permanently removes a dynamic instance of a WebPart control from a Web page.

DisconnectWebPart(WebPart) DisconnectWebPart(WebPart) DisconnectWebPart(WebPart) DisconnectWebPart(WebPart)

Удаляет WebPart или серверный элемент управления, который закрывается или удаляется из любого подключения, в котором принимал участие.Removes a WebPart or server control that is being closed or deleted from any connections it is participating in.

DisconnectWebParts(WebPartConnection) DisconnectWebParts(WebPartConnection) DisconnectWebParts(WebPartConnection) DisconnectWebParts(WebPartConnection)

Выполняет отключение серверных элементов управления, которые подключены на веб-странице.Carries out the process of disconnecting server controls that are connected on a Web page.

Dispose() Dispose() Dispose() Dispose()

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.Ends design-time tracing of rendering data.

(Inherited from Control)
EndWebPartConnecting() EndWebPartConnecting() EndWebPartConnecting() EndWebPartConnecting()

Завершает процесс подключения элемента управления WebPart к другому элементу управления.Completes the process of connecting a WebPart control to another control.

EndWebPartEditing() EndWebPartEditing() EndWebPartEditing() EndWebPartEditing()

Завершает редактирование элемента управления WebPart.Completes the process of editing a WebPart control.

EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines whether the server control contains child controls. Если дочерних элементов управления нет, они будут созданы.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExportWebPart(WebPart, XmlWriter) ExportWebPart(WebPart, XmlWriter) ExportWebPart(WebPart, XmlWriter) ExportWebPart(WebPart, XmlWriter)

Создает XML-файл описания, который содержит состояние и данные свойства для серверного элемента управления.Creates an XML description file that contains state and property data for a server control.

FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Эту версию метода FindControl не следует переопределять.You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Переопределен для предотвращения перевода фокуса на элемент управления WebPartManager, так как для последнего отсутствует пользовательский интерфейс.Overridden to prevent focus from ever being set on the WebPartManager control, because it has no user interface (UI).

GetConsumerConnectionPoints(WebPart) GetConsumerConnectionPoints(WebPart) GetConsumerConnectionPoints(WebPart) GetConsumerConnectionPoints(WebPart)

Получает коллекцию объектов ConsumerConnectionPoint, которые могут функционировать в качестве точек подключения серверного элемента управления, выполняющего роль получателя в подключении веб-частей.Retrieves the collection of ConsumerConnectionPoint objects that can act as connection points from a server control that is acting as a consumer within a Web Parts connection.

GetCurrentWebPartManager(Page) GetCurrentWebPartManager(Page) GetCurrentWebPartManager(Page) GetCurrentWebPartManager(Page)

Получает ссылку на текущий экземпляр элемента управления WebPartManager на странице.Retrieves a reference to the current instance of the WebPartManager control on a page.

GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

Возвращает данные времени разработки для элемента управления.Gets design-time data for a control.

(Inherited from Control)
GetDisplayTitle(WebPart) GetDisplayTitle(WebPart) GetDisplayTitle(WebPart) GetDisplayTitle(WebPart)

Возвращает строку, содержащую значение для свойства DisplayTitle элемента управления WebPart.Gets a string containing the value for the DisplayTitle property of a WebPart control.

GetExportUrl(WebPart) GetExportUrl(WebPart) GetExportUrl(WebPart) GetExportUrl(WebPart)

Возвращает относительный виртуальный путь и строку запроса, которые являются частью запроса, если пользователь пытается экспортировать элемент управления WebPart.Gets the relative virtual path and the query string that are part of the request when a user attempts to export a WebPart control.

GetGenericWebPart(Control) GetGenericWebPart(Control) GetGenericWebPart(Control) GetGenericWebPart(Control)

Возвращает ссылку на экземпляр элемента управления GenericWebPart, содержащий серверный элемент управления.Gets a reference to the instance of the GenericWebPart control that contains a server control.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetProviderConnectionPoints(WebPart) GetProviderConnectionPoints(WebPart) GetProviderConnectionPoints(WebPart) GetProviderConnectionPoints(WebPart)

Получает коллекцию объектов ProviderConnectionPoint, которые могут функционировать в качестве точек подключения серверного элемента управления, выполняющего роль поставщика в подключении веб-частей.Retrieves the collection of ProviderConnectionPoint objects that can act as connection points from a server control that is acting as a provider within a Web Parts connection.

GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Возвращает часть с префиксом свойства UniqueID указанного элемента управления.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls() HasControls() HasControls() HasControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents() HasEvents() HasEvents() HasEvents()

Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
ImportWebPart(XmlReader, String) ImportWebPart(XmlReader, String) ImportWebPart(XmlReader, String) ImportWebPart(XmlReader, String)

Импортирует XML-файл описания, который содержит данные состояния и свойств для элемента управления WebPart и применяет эти данные к элементу управления.Imports an XML description file that contains state and property data for a WebPart control, and applies the data to the control.

IsAuthorized(Type, String, String, Boolean) IsAuthorized(Type, String, String, Boolean) IsAuthorized(Type, String, String, Boolean) IsAuthorized(Type, String, String, Boolean)

Выполняет завершающие действия по определению, авторизован ли элемент управления для добавления на страницу.Carries out the final steps in determining whether a control is authorized to be added to a page.

IsAuthorized(WebPart) IsAuthorized(WebPart) IsAuthorized(WebPart) IsAuthorized(WebPart)

Выполняет начальные действия по определению, авторизован ли элемент управления для добавления на страницу.Carries out the initial steps in determining whether a control is authorized to be added to a page.

IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

Определяет наличие у серверного элемента управления только текстового содержимого.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Загружает данные состояния элемента управления, которые были сохранены после предыдущего запроса страницы и должны быть восстановлены в последующем запросе.Loads control state data that was saved from a previous page request, and needs to be restored on a subsequent request.

LoadCustomPersonalizationState(PersonalizationDictionary) LoadCustomPersonalizationState(PersonalizationDictionary) LoadCustomPersonalizationState(PersonalizationDictionary) LoadCustomPersonalizationState(PersonalizationDictionary)

Сохраняет пользовательские данные персонализации, переданные объектами персонализации в элемент управления WebPartManager для использования в будущем процессе инициализации.Stores the custom personalization data that has been passed to the WebPartManager control by the personalization objects to be used later during the initialization process.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(Inherited from Control)
MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MoveWebPart(WebPart, WebPartZoneBase, Int32) MoveWebPart(WebPart, WebPartZoneBase, Int32) MoveWebPart(WebPart, WebPartZoneBase, Int32) MoveWebPart(WebPart, WebPartZoneBase, Int32)

Перемещает объект WebPart или серверный элемент управления из одной зоны WebPartZoneBase в другую или в новую позицию в той же зоне.Moves a WebPart or server control from one WebPartZoneBase zone to another, or to a new position within the same zone.

OnAuthorizeWebPart(WebPartAuthorizationEventArgs) OnAuthorizeWebPart(WebPartAuthorizationEventArgs) OnAuthorizeWebPart(WebPartAuthorizationEventArgs) OnAuthorizeWebPart(WebPartAuthorizationEventArgs)

Создает событие AuthorizeWebPart и вызывает обработчик для этого события, если таковой существует.Raises the AuthorizeWebPart event and invokes a handler for the event, if one exists.

OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnConnectionsActivated(EventArgs) OnConnectionsActivated(EventArgs) OnConnectionsActivated(EventArgs) OnConnectionsActivated(EventArgs)

Создает событие ConnectionsActivated для указания загрузки страницы и ее элементов управления, а также активации подключений на странице, что означает готовность к началу совместного использования данных.Raises the ConnectionsActivated event to indicate that a page and its controls are loaded, and connections on the page have been activated to begin sharing data.

OnConnectionsActivating(EventArgs) OnConnectionsActivating(EventArgs) OnConnectionsActivating(EventArgs) OnConnectionsActivating(EventArgs)

Создает событие ConnectionsActivating для указания загрузки страницы и ее элементов управления, а также возможности активации подключений.Raises the ConnectionsActivating event to indicate that a page and its controls have loaded, and the process of activating connections can begin.

OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Создает событие DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnDisplayModeChanged(WebPartDisplayModeEventArgs) OnDisplayModeChanged(WebPartDisplayModeEventArgs) OnDisplayModeChanged(WebPartDisplayModeEventArgs) OnDisplayModeChanged(WebPartDisplayModeEventArgs)

Создает событие DisplayModeChanged для указания того, что элемент управления WebPartManager завершил переключение на веб-странице из одного режима отображения в другой.Raises the DisplayModeChanged event to indicate that the WebPartManager control has completed the process of switching from one display mode to another on a Web page.

OnDisplayModeChanging(WebPartDisplayModeCancelEventArgs) OnDisplayModeChanging(WebPartDisplayModeCancelEventArgs) OnDisplayModeChanging(WebPartDisplayModeCancelEventArgs) OnDisplayModeChanging(WebPartDisplayModeCancelEventArgs)

Создает событие DisplayModeChanging для указания того, что элемент управления WebPartManager находится в процессе переключения из одного режима отображения в другой.Raises the DisplayModeChanging event to indicate that the WebPartManager control is in the process of switching from one display mode to another on a Web page.

OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Создает событие Init, которое является первым событием в жизненном цикле элемента управления WebPartManager.Raises the Init event, which is the first event in the WebPartManager control life cycle.

OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Создает событие Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Создает событие PreRender, которое происходит перед визуализацией элемента управления WebPartManager на веб-странице.Raises the PreRender event, which occurs just before a WebPartManager control is rendered on a Web page.

OnSelectedWebPartChanged(WebPartEventArgs) OnSelectedWebPartChanged(WebPartEventArgs) OnSelectedWebPartChanged(WebPartEventArgs) OnSelectedWebPartChanged(WebPartEventArgs)

Создает событие SelectedWebPartChanged, которое происходит после выбора элемента управления WebPart или отмены выбора этого элемента управления.Raises the SelectedWebPartChanged event, which occurs after a WebPart control has either been newly selected or had its selection cleared.

OnSelectedWebPartChanging(WebPartCancelEventArgs) OnSelectedWebPartChanging(WebPartCancelEventArgs) OnSelectedWebPartChanging(WebPartCancelEventArgs) OnSelectedWebPartChanging(WebPartCancelEventArgs)

Создает событие SelectedWebPartChanging, которое происходит во время изменения текущего выбора элементов управления WebPart.Raises the SelectedWebPartChanging event, which occurs during the process of changing which WebPart control is currently selected.

OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Создает базовое событие Unload и удаляет экземпляр WebPartManager с веб-страницы.Raises the base Unload event and removes the WebPartManager instance from a Web page.

OnWebPartAdded(WebPartEventArgs) OnWebPartAdded(WebPartEventArgs) OnWebPartAdded(WebPartEventArgs) OnWebPartAdded(WebPartEventArgs)

Создает событие WebPartAdded, которое происходит после добавления на страницу элемента управления WebPart.Raises the WebPartAdded event, which occurs after a WebPart control has been added to a page.

OnWebPartAdding(WebPartAddingEventArgs) OnWebPartAdding(WebPartAddingEventArgs) OnWebPartAdding(WebPartAddingEventArgs) OnWebPartAdding(WebPartAddingEventArgs)

Создает событие WebPartAdding, которое происходит во время процесса добавления элемента управления WebPart (или серверного, или пользовательского элемента управления) в зону WebPartZoneBase.Raises the WebPartAdding event, which occurs during the process of adding a WebPart control (or a server or user control) to a WebPartZoneBase zone.

OnWebPartClosed(WebPartEventArgs) OnWebPartClosed(WebPartEventArgs) OnWebPartClosed(WebPartEventArgs) OnWebPartClosed(WebPartEventArgs)

Создает событие WebPartClosed для оповещение об удалении элемента управления со страницы.Raises the WebPartClosed event to signal that a control has been removed from a page.

OnWebPartClosing(WebPartCancelEventArgs) OnWebPartClosing(WebPartCancelEventArgs) OnWebPartClosing(WebPartCancelEventArgs) OnWebPartClosing(WebPartCancelEventArgs)

Создает событие WebPartClosing, которое происходит во время удаления со страницы серверного элемента управления или объекта WebPart.Raises the WebPartClosing event, which occurs during the process of a WebPart or server control being removed from a page.

OnWebPartDeleted(WebPartEventArgs) OnWebPartDeleted(WebPartEventArgs) OnWebPartDeleted(WebPartEventArgs) OnWebPartDeleted(WebPartEventArgs)

Создает событие WebPartDeleted, которое происходит после окончательного удаления со страницы элемента управления WebPart.Raises the WebPartDeleted event, which occurs after a WebPart control has been permanently deleted from a page.

OnWebPartDeleting(WebPartCancelEventArgs) OnWebPartDeleting(WebPartCancelEventArgs) OnWebPartDeleting(WebPartCancelEventArgs) OnWebPartDeleting(WebPartCancelEventArgs)

Создает событие WebPartDeleting, которое указывает, что динамический элемент управления WebPart (или серверный, или пользовательский элемент управления, содержащийся в зоне WebPartZoneBase) находится в процессе удаления.Raises the WebPartDeleting event, which indicates that a dynamic WebPart control (or server or user control that is contained in a WebPartZoneBase zone) is in the process of being deleted.

OnWebPartMoved(WebPartEventArgs) OnWebPartMoved(WebPartEventArgs) OnWebPartMoved(WebPartEventArgs) OnWebPartMoved(WebPartEventArgs)

Создает событие WebPartMoved, которое происходит после перемещения элемента управления WebPart в другое место на странице.Raises the WebPartMoved event, which occurs after a WebPart control has been moved to a different location on a page.

OnWebPartMoving(WebPartMovingEventArgs) OnWebPartMoving(WebPartMovingEventArgs) OnWebPartMoving(WebPartMovingEventArgs) OnWebPartMoving(WebPartMovingEventArgs)

Создает событие WebPartMoving, которое указывает, что WebPart или серверный, или пользовательский элемент управления в зоне WebPartZoneBase находится в процессе перемещения.Raises the WebPartMoving event, which indicates that a WebPart or server or user control in a WebPartZoneBase zone is in the process of being moved.

OnWebPartsConnected(WebPartConnectionsEventArgs) OnWebPartsConnected(WebPartConnectionsEventArgs) OnWebPartsConnected(WebPartConnectionsEventArgs) OnWebPartsConnected(WebPartConnectionsEventArgs)

Создает событие WebPartsConnected, которое происходит после установки подключения между элементами управления WebPart.Raises the WebPartsConnected event, which occurs after a connection has been established between WebPart controls.

OnWebPartsConnecting(WebPartConnectionsCancelEventArgs) OnWebPartsConnecting(WebPartConnectionsCancelEventArgs) OnWebPartsConnecting(WebPartConnectionsCancelEventArgs) OnWebPartsConnecting(WebPartConnectionsCancelEventArgs)

Создает событие WebPartsConnecting, которое происходит во время установки подключения между двумя WebPart или серверными, или пользовательскими элементами управления, содержащимися в зоне WebPartZoneBase.Raises the WebPartsConnecting event, which occurs during the process of establishing a connection between two WebPart or server or user controls contained in a WebPartZoneBase zone.

OnWebPartsDisconnected(WebPartConnectionsEventArgs) OnWebPartsDisconnected(WebPartConnectionsEventArgs) OnWebPartsDisconnected(WebPartConnectionsEventArgs) OnWebPartsDisconnected(WebPartConnectionsEventArgs)

Создает событие WebPartsDisconnected, которое происходит после завершения подключения между элементами управления WebPart.Raises the WebPartsDisconnected event, which occurs after a connection between WebPart controls has ended.

OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs) OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs) OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs) OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)

Создает событие WebPartsDisconnecting, которое указывает, что два объекта WebPart или серверных, или пользовательских элементов управления в зоне WebPartZoneBase находятся в процессе завершения подключения.Raises the WebPartsDisconnecting event, which indicates that two WebPart or server or user controls in a WebPartZoneBase zone are in the process of ending a connection.

OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

Возвращает Stream, используемое для чтения файла.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RegisterClientScript() RegisterClientScript() RegisterClientScript() RegisterClientScript()

Разрешает элементу управления WebPartManager запустить скрипт на стороне клиента, который используется для различных функциональных возможностей персонализации, таких как перетаскивание элементов управления WebPart на веб-странице.Enables the WebPartManager control to emit client-side script that is used for various personalization features, such as dragging WebPart controls in a Web page.

RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Переопределен, чтобы не дать элементу управления WebPartManager отрисовать какое-либо содержимое.Overridden to prevent the WebPartManager control from rendering any content.

RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() SaveControlState()

Сохраняет данные состояния для элемента управления WebPartManager, так что данные могут быть восстановлены при будущих запросах веб-страницы, содержащей элемент управления.Saves state data for the WebPartManager control so the data can be restored on future request to the Web page that contains the control.

SaveCustomPersonalizationState(PersonalizationDictionary) SaveCustomPersonalizationState(PersonalizationDictionary) SaveCustomPersonalizationState(PersonalizationDictionary) SaveCustomPersonalizationState(PersonalizationDictionary)

Сохраняет данные состояния пользовательской персонализации, поддерживаемые элементом управления WebPartManager, чтобы эти данные могли быть повторно загружены при повторной загрузке страницы.Saves custom personalization state data maintained by the WebPartManager control, so that this data can be reloaded whenever the page is reloaded.

SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Сохраняет любые изменения состояния просмотра серверного элемента управления, произошедшие после отправки страницы обратно на сервер.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Задает данные времени разработки для элемента управления.Sets design-time data for a control.

(Inherited from Control)
SetPersonalizationDirty() SetPersonalizationDirty() SetPersonalizationDirty() SetPersonalizationDirty()

Задает флаг, указывающий, что пользовательские данные персонализации для элемента управления WebPartManager были изменены.Sets a flag indicating that custom personalization data for the WebPartManager control has changed.

SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetSelectedWebPart(WebPart) SetSelectedWebPart(WebPart) SetSelectedWebPart(WebPart) SetSelectedWebPart(WebPart)

Задает значение свойства SelectedWebPart равным выбранному в настоящий момент WebPart или серверному элементу управления.Sets the SelectedWebPart property value equal to the currently selected WebPart or server control.

SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Применяет данные состояния персонализации к элементу управления WebPartManager и вызывает базовый метод для разрешения отслеживания изменений данных состояния просмотра для этого элемента управления.Applies personalization state data to the WebPartManager control, and calls the base method to enable tracking changes to the view-state data for the control.

События

AuthorizeWebPart AuthorizeWebPart AuthorizeWebPart AuthorizeWebPart

Происходит при вызове метода IsAuthorized для определения, можно ли добавить на страницу объект WebPart или серверный элемент управления.Occurs when the IsAuthorized method is called to determine whether a WebPart or server control can be added to a page.

ConnectionsActivated ConnectionsActivated ConnectionsActivated ConnectionsActivated

Происходит после того, как все текущие подключения веб-частей на странице не только будут подключены, но и начнут активно обмениваться данными между элементами управления поставщиков и получателей в каждом подключении.Occurs after all the current Web Parts connections on a page are not only connected, but have also begun actively sharing data between the consumer and provider controls involved in each connection.

ConnectionsActivating ConnectionsActivating ConnectionsActivating ConnectionsActivating

Происходит во время активации всех установленных подключений веб-частей на веб-странице.Occurs during the process of activating all the established Web Parts connections on a Web page.

DataBinding DataBinding DataBinding DataBinding

Происходит при привязке серверного элемента управления к источнику данных.Occurs when the server control binds to a data source.

(Inherited from Control)
DisplayModeChanged DisplayModeChanged DisplayModeChanged DisplayModeChanged

Происходит после изменения текущего режима отображения на странице веб-частей.Occurs after the current display mode on a Web Parts page has changed.

DisplayModeChanging DisplayModeChanging DisplayModeChanging DisplayModeChanging

Происходит после щелчка пользователем команды на веб-странице, которая запускает процесс переключения в другой режим отображения.Occurs after a user clicks a verb on a Web page that begins the process of changing to a different display mode.

Disposed Disposed Disposed Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init Init Init Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Происходит при загрузке серверного элемента управления в объект Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender PreRender PreRender PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
SelectedWebPartChanged SelectedWebPartChanged SelectedWebPartChanged SelectedWebPartChanged

Происходит после изменение и перемещения выбранного элемента управления WebPart в другой элемент управления на веб-странице.Occurs after the selection of one WebPart control has changed and moved to another control on a Web page.

SelectedWebPartChanging SelectedWebPartChanging SelectedWebPartChanging SelectedWebPartChanging

Происходит во время изменения текущего выбора на странице элемента управления WebPart или серверного элемента управления.Occurs during the process of changing which WebPart or server control is currently selected on a Web page.

Unload Unload Unload Unload

Происходит при выгрузке серверного элемента управления из памяти.Occurs when the server control is unloaded from memory.

(Inherited from Control)
WebPartAdded WebPartAdded WebPartAdded WebPartAdded

Происходит после добавления динамического или другого элемента управления WebPart в зону WebPartZoneBase для указания успешного добавления элемента управления.Occurs after a dynamic WebPart or other server control has been added to a WebPartZoneBase zone, to indicate that the control was added successfully.

WebPartAdding WebPartAdding WebPartAdding WebPartAdding

Происходит во время процесса добавления динамического WebPart или другого серверного элемента управления в зону WebPartZoneBase.Occurs during the process of adding a dynamic WebPart or other server control to a WebPartZoneBase zone.

WebPartClosed WebPartClosed WebPartClosed WebPartClosed

Происходит при удалении со страницы элемента управления WebPart (или серверный, или пользовательский элемент управления).Occurs when a WebPart control (or server or user control) is removed from a page.

WebPartClosing WebPartClosing WebPartClosing WebPartClosing

Происходит во время удаления элемента управления WebPart control (или серверного, или пользовательского элемента управления) со страницы.Occurs during the process of removing a WebPart control (or server or user control) from a page.

WebPartDeleted WebPartDeleted WebPartDeleted WebPartDeleted

Происходит после удаления элемента управления WebPart или другого серверного элемента управления из зоны WebPartZoneBase.Occurs after a WebPart or other server control has been deleted from a WebPartZoneBase zone.

WebPartDeleting WebPartDeleting WebPartDeleting WebPartDeleting

Происходит во время процесса окончательного удаления экземпляра динамического WebPart или другого серверного элемента управления из зоны WebPartZoneBase.Occurs during the process of permanently deleting an instance of a dynamic WebPart or other server control from a WebPartZoneBase zone.

WebPartMoved WebPartMoved WebPartMoved WebPartMoved

Происходит после перемещения в другое место веб-страницы элемента управления WebPart или серверного элемента управления.Occurs after a WebPart or server control has been moved to a different location on a Web page.

WebPartMoving WebPartMoving WebPartMoving WebPartMoving

Происходит во время процесса перемещения WebPart или другого серверного элемента, содержащегося в зоне WebPartZoneBase.Occurs during the process of moving a WebPart or other server control that is contained in a WebPartZoneBase zone.

WebPartsConnected WebPartsConnected WebPartsConnected WebPartsConnected

Происходит после установки определенного подключения между элементами управления WebPart (или серверными, или пользовательскими элементами управления).Occurs after a specific connection has been established between WebPart controls (or server or user controls).

WebPartsConnecting WebPartsConnecting WebPartsConnecting WebPartsConnecting

Происходит во время процесса создания подключения между элементами управления WebPart (или серверными, или пользовательскими элементами управления, размещенными в зоне WebPartZoneBase).Occurs during the process of creating a connection between WebPart controls (or server or user controls placed in a WebPartZoneBase zone).

WebPartsDisconnected WebPartsDisconnected WebPartsDisconnected WebPartsDisconnected

Происходит после разрыва подключения между двумя элементами управления WebPart или серверными элементами управления.Occurs after a connection between two WebPart or server controls has been terminated.

WebPartsDisconnecting WebPartsDisconnecting WebPartsDisconnecting WebPartsDisconnecting

Происходит во время процесса завершения подключения между ранее подключенными WebPart или серверными элементами управления.Occurs during the process of ending the connection between previously connected WebPart or server controls.

Явные реализации интерфейса

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

Описание этого члена см. в разделе SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)
IPersonalizable.IsDirty IPersonalizable.IsDirty IPersonalizable.IsDirty IPersonalizable.IsDirty

Возвращает значение, которое указывает, были ли изменены на веб-страницы данные состояния персонализации, управляемые элементом управления WebPartManager.Gets a value that indicates whether custom personalization state data managed by the WebPartManager control has changed on a Web page.

IPersonalizable.Load(PersonalizationDictionary) IPersonalizable.Load(PersonalizationDictionary) IPersonalizable.Load(PersonalizationDictionary) IPersonalizable.Load(PersonalizationDictionary)

Возвращает сохраненные данные о состоянии пользовательской персонализации, которые требуется загрузить в элемент управления WebPartManager.Returns previously saved custom personalization state data that needs to be loaded to the WebPartManager control.

IPersonalizable.Save(PersonalizationDictionary) IPersonalizable.Save(PersonalizationDictionary) IPersonalizable.Save(PersonalizationDictionary) IPersonalizable.Save(PersonalizationDictionary)

Сохраняет пользовательские данные состояния персонализации, которые управляются элементом управления WebPartManager.Saves custom personalization state data that is managed by the WebPartManager control.

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

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer)

Получает коллекцию значений по умолчанию для заданного элемента управления данными.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer)

Получает метаданные таблицы для заданного элемента управления данными.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable)

Задает метаданные таблицы для заданного элемента управления данными.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable)

Определяет, доступны ли метаданные таблицы.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

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

Дополнительно