WebPartManager Clase

Definición

Actúa como clase central del conjunto de controles de elementos web, ya que administra todos los controles de elementos web, la funcionalidad y los eventos que se producen en una página web.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
[<System.ComponentModel.Bindable(false)>]
type WebPartManager = class
    inherit Control
    interface INamingContainer
    interface IPersonalizable
Public Class WebPartManager
Inherits Control
Implements INamingContainer, IPersonalizable
Herencia
WebPartManager
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra el uso del control mediante programación y declarativo WebPartManager .The following code example demonstrates both declarative and programmatic use of the WebPartManager control.

El ejemplo de código tiene cuatro partes:The code example has four parts:

  • Control de usuario que le permite cambiar los modos de presentación en una página de elementos web.A user control that enables you to change display modes on a Web Parts page.

  • Una página web que contiene dos WebPart controles personalizados que se pueden conectar y un <asp:webpartmanager> elemento.A Web page that contains two custom WebPart controls that can be connected, and an <asp:webpartmanager> element.

  • Un archivo de código fuente que contiene dos WebPart controles personalizados y una interfaz personalizada.A source code file that contains two custom WebPart controls, and a custom interface.

  • Explicación de cómo funciona el ejemplo en un explorador.An explanation of how the example works in a browser.

El control de usuario tiene un control de lista desplegable que muestra los posibles modos de presentación en una página, dados los elementos web controles que están presentes en la página.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. En la Página Web de este ejemplo de código, este control de usuario se declara justo debajo del WebPartManager elemento en el marcado de la página y hay una Register Directiva cerca de la parte superior de la página web para registrar el control.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. Para obtener más información sobre los modos de presentación y una descripción del código fuente de este control, vea Tutorial: cambiar los modos de presentación en una página de elementos Web.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>

El marcado declarativo de la página web contiene las Register directivas para el control de usuario y los controles personalizados.The declarative markup for the Web page contains Register directives for both the user control and the custom controls. Hay un <asp:webpartmanager> elemento, un <asp:webpartzone> elemento que contiene los controles personalizados y un <asp:connectionszone> elemento.There is an <asp:webpartmanager> element, an <asp:webpartzone> element to contain the custom controls, and an <asp:connectionszone> element. La página también contiene código en línea que controla los eventos relacionados con la conexión para el WebPartManager control; puede ver el efecto de este código mientras conecta y desconecta los controles.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>

La tercera parte del ejemplo es el código fuente de los controles.The third part of the example is the source code for the controls. Tenga en cuenta que hay una interfaz denominada IZipCode y esta interfaz se implementa en la ZipCodeWebPart clase.Note that there is an interface named IZipCode, and this interface is implemented in the ZipCodeWebPart class. Esta clase tiene un método de devolución de llamada especial denominado ProvideIZipCode que actúa como proveedor.This class has a special callback method named ProvideIZipCode that serves as a provider. El otro tipo, denominado WeatherWebPart , también se implementa con un método especial denominado GetIZipCode , que permite que el control actúe como consumidor del otro control.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.

Para que el ejemplo de código se ejecute, debe compilar este código fuente.For the code example to run, you must compile this source code. Puede compilarlo explícitamente y colocar el ensamblado resultante en la carpeta bin del sitio web o en la caché global de ensamblados.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Como alternativa, puede colocar el código fuente en la carpeta App_Code del sitio, donde se compilará dinámicamente en tiempo de ejecución.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. En este ejemplo de código se supone que ha compilado el origen en un ensamblado y que la Register Directiva de la página web hace referencia al nombre del ensamblado.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. Para ver un tutorial que muestra cómo compilar, vea Tutorial: desarrollar y utilizar un control de servidor web personalizado.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

Después de cargar la página web en un explorador, haga clic en el control de lista desplegable modo de presentación y seleccione conectar para cambiar la página al modo de conexión.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. El modo de conexión utiliza el <asp:connectionszone> elemento para que pueda crear conexiones entre los controles.Connect mode uses the <asp:connectionszone> element to enable you to create connections between controls. En el modo de conexión, haga clic en la flecha hacia abajo de la barra de título del control de código postal para activar su menú de verbos y, a continuación, haga clic en conectar.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. Después de que aparezca la interfaz de usuario de conexión, haga clic en el vínculo crear una conexión a un consumidor .After the connection UI appears, click the Create a connection to a Consumer link. Aparece una celda con un control de lista desplegable.A cell appears that has a drop-down list control. Seleccione control meteorológico en la lista desplegable y, a continuación, haga clic en conectar para completar la conexión de los dos controles.Select Weather Control in the drop-down list, and then click Connect to complete the connection of the two controls. Haga clic en cerrary, a continuación, use la lista desplegable modo de presentación para devolver la página al modo de exploración normal.Click Close, and then use the Display Mode drop-down list to return the page to normal browse mode. Puede escribir un código postal y el control consumidor se actualizará con el valor que especifique.You can enter a ZIP Code, and the consumer control will be updated with the value you enter. Dado que la ZipCode propiedad se marcó con el Personalizable atributo en el código fuente, el valor de esta propiedad se conservará en las sesiones del explorador, con lo que se guardará el valor especificado por un usuario.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. Un control consumidor más sofisticado podría tomar la información del código postal, buscar información meteorológica en función del código y mostrarla a un usuario.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.

Comentarios

El WebPartManager control actúa como centro o centro de control de una aplicación elementos Web.The WebPartManager control acts as the hub or control center of a Web Parts application. Debe haber una única instancia de control (y solo una) WebPartManager en cada página que use controles de elementos Web.There must be one--and only one--WebPartManager control instance on every page that uses Web Parts controls. Al igual que en la mayoría de los aspectos de las aplicaciones elementos web, el WebPartManager control solo funciona con usuarios autenticados.As with most aspects of Web Parts applications, the WebPartManager control works only with authenticated users. Además, su funcionalidad funciona casi completamente con controles de servidor que residen en elementos web zonas que heredan de la WebZone clase.Further, its functionality works almost entirely with server controls that reside within Web Parts zones that inherit from the WebZone class. Los controles de servidor que residen en una página fuera de estas zonas pueden tener muy poco elementos web funcionalidad o interacción con el WebPartManager control.Server controls that reside on a page outside of these zones can have very little Web Parts functionality or interaction with the WebPartManager control.

Como concentrador para elementos web funcionalidad en una página, el WebPartManager control lleva a cabo los tipos de tareas que se describen en la tabla siguiente.As the hub for Web Parts functionality on a page, the WebPartManager control carries out the kinds of tasks described in the following table.

Categoría de la tarea:Task category Lo que hace el controlWhat the control does
Seguimiento de controles de elementos webTracking Web Parts controls Realiza un seguimiento de los muchos tipos diferentes de controles de una página que proporcionan elementos web características, como WebPart controles, conexiones, zonas y otros.Keeps track of the many different kinds of controls on a page that provide Web Parts features, including WebPart controls, connections, zones, and others.
Agregar y quitar controles elementos webAdding and removing Web Parts controls Proporciona los métodos para agregar, eliminar y cerrar WebPart controles en una página.Provides the methods for adding, deleting, and closing WebPart controls on a page.
Administrar conexionesAdministering connections Crea conexiones entre los controles y supervisa las conexiones, así como los procesos de agregarlos y quitarlos.Creates connections between controls, and monitors the connections as well as the processes of adding and removing them.
Personalización de controles y páginasPersonalizing controls and pages Permite a los usuarios trasladar controles a diferentes ubicaciones de una página e inicia las vistas en las que los usuarios pueden editar la apariencia, las propiedades y el comportamiento de los controles.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. Mantiene la configuración de personalización específica del usuario en cada página.Maintains user-specific personalization settings on each page.
Alternar entre diferentes vistas de páginaToggling between different page views Cambia una página entre diferentes vistas especializadas de la página, de modo que los usuarios pueden llevar a cabo ciertas tareas, como cambiar el diseño de página o los controles de edición.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.
Generar elementos web eventos de ciclo de vidaRaising Web Parts life-cycle events Define, genera y permite a los desarrolladores controlar los eventos de ciclo de vida de elementos web controles, como cuando se agregan, se mueven, se conectan o se eliminan controles.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.
Habilitar la importación y la exportación de controlesEnabling import and export of controls Exporta secuencias XML que contienen el estado de las propiedades de los WebPart controles, y permite a los usuarios importar los archivos para mayor comodidad en la personalización de controles complejos en otras páginas o sitios.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.

La WebPartManager clase tiene un conjunto grande de propiedades.The WebPartManager class has a large set of properties. Coherente con el WebPartManager rol de seguimiento de otros controles, tiene una serie de propiedades que hacen referencia a colecciones de elementos Web controles u otros objetos elementos Web especiales.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. Las AvailableTransformers Connections propiedades,, Controls ,, DisplayModes DynamicConnections , SupportedDisplayModes , WebParts y Zones son todas las colecciones utilizadas por el WebPartManager control para su seguimiento y otras tareas de administración.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.

Otro grupo de propiedades contiene advertencias personalizables que se aplican en ciertos escenarios que se producen en una aplicación elementos web.Another group of properties contains customizable warnings that apply in certain scenarios that occur in a Web Parts application. Entre ellas se incluyen las CloseProviderWarning DeleteWarning propiedades, y ExportSensitiveDataWarning .These include the CloseProviderWarning, the DeleteWarning, and the ExportSensitiveDataWarning properties.

La WebPartManager clase invalida algunas de sus propiedades heredadas base, utilizadas por muchos controles de servidor Web.The WebPartManager class overrides some of its base inherited properties, which are used by many Web server controls. Entre ellas se incluyen las EnableTheming SkinID propiedades, y Visible .These include the EnableTheming, SkinID, and Visible properties.

Por último, hay un grupo de propiedades útil para tener acceso al estado actual de la aplicación.Finally, there is a group of properties useful for accessing the current state of the application. La DisplayMode propiedad indica el modo de presentación actual en el que se encuentra una página.The DisplayMode property indicates the current display mode that a page is in. La EnableClientScript propiedad indica si un control puede representar el script del lado cliente, que es pertinente en situaciones en las que los usuarios pueden tener exploradores con distintas capacidades o tener desactivado el script.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. La Internals propiedad es útil para hacer referencia a una clase de utilidad que contiene las llamadas a varios métodos de elementos Web importantes que se usan para los casos de extensibilidad.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. Al ocultar las llamadas a estos métodos en una clase independiente (la WebPartManagerInternals clase), WebPartManager se simplifica la propia API de la clase.By hiding the calls to these methods in a separate class (the WebPartManagerInternals class), the WebPartManager class's own API is simplified. La Personalization propiedad proporciona acceso a los objetos de personalización que almacenan la configuración de personalización de los usuarios y conservan los datos en el almacenamiento permanente.The Personalization property provides access to the personalization objects that store users' personalization settings and persist that data to permanent storage. La SelectedWebPart propiedad indica qué WebPart control de una página está seleccionado actualmente por el usuario o la aplicación.The SelectedWebPart property indicates which WebPart control on a page is currently selected by the user or the application. La IPersonalizable.IsDirty propiedad indica si han cambiado los datos de personalización personalizados en un WebPart control.The IPersonalizable.IsDirty property indicates whether custom personalization data on a WebPart control has changed.

El WebPartManager control contiene cinco modos de presentación integrados o vistas de una página web.The WebPartManager control contains five built-in display modes, or views of a Web page. Los desarrolladores pueden extender esta característica, creando modos de presentación personalizados mediante la extensión de tipos como la WebZone clase o la ToolZone clase.Developers can extend this feature, creating custom display modes by extending types such as the WebZone class or the ToolZone class. Los usuarios pueden cambiar una página a los distintos modos de visualización, siempre que el tipo de controles adecuado que corresponda a un modo de presentación determinado esté presente en una página.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.

Nota

Es posible extender esta característica para que los usuarios puedan cambiar a un modo de presentación personalizado sin tener una zona correspondiente en la página.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. Sin embargo, el comportamiento predeterminado es que los modos de presentación se corresponden con las zonas.However, the default behavior is that display modes correspond to zones.

Los modos de presentación estándar se representan mediante campos públicos en la WebPartManager clase.The standard display modes are represented by public fields in the WebPartManager class. En la tabla siguiente se resumen los campos y los modos de presentación a los que hacen referencia.The following table summarizes the fields and the display modes they refer to. El modo de presentación actual de una página, como se indicó anteriormente, siempre se hace referencia en la DisplayMode propiedad, y el conjunto de modos de presentación que es posible en una página determinada, dado el tipo de zonas que están presentes en la página, se incluye en la SupportedDisplayModes propiedad.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.

CampoField Detalles del modo de presentaciónDisplay mode details
BrowseDisplayMode Vista de usuario normal de una página web; el modo de presentación predeterminado y el más común.The normal user view of a Web page; the default and most common display mode.
DesignDisplayMode Vista en la que los usuarios pueden reorganizar o eliminar controles para cambiar el diseño de página.The view in which users can rearrange or delete controls to change the page layout.
EditDisplayMode Vista en la que se hace visible una interfaz de usuario de edición. los usuarios pueden editar la apariencia, las propiedades y el comportamiento de los controles que están visibles en el modo de exploración normal.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 Vista en la que se hace visible una interfaz de usuario del catálogo; los usuarios pueden agregar controles a una página de los catálogos de controles disponibles.The view in which a catalog UI becomes visible; users can add controls to a page from catalogs of available controls.
ConnectDisplayMode Vista en la que se hace visible una interfaz de usuario de conexión; los usuarios pueden conectar, administrar o desconectar conexiones entre los controles.The view in which a connection UI becomes visible; users can connect, manage, or disconnect connections between controls.

El WebPartManager control también contiene una serie de eventos que son críticos en el ciclo de vida de elementos web páginas y controles.The WebPartManager control also contains a number of events that are critical in the life cycle of Web Parts pages and controls. Estos eventos proporcionan un control preciso mediante programación sobre el comportamiento de los controles de elementos web.These events provide precise programmatic control over the behavior of Web Parts controls. La mayoría de los métodos pertenecen directamente a WebPart los controles (u otros controles de servidor o de usuario que se colocan en WebPartZoneBase zonas para que puedan comportarse como WebPart controles).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). Sin embargo, algunos eventos pertenecen al estado de la página o las conexiones de la página.However, a few events pertain to the state of the page or connections on the page. En la tabla siguiente se enumeran los eventos disponibles y se resumen sus propósitos.The following table lists the available events and summarizes their purposes.

Nota

En todos los casos de la tabla siguiente, la palabra "control" hace referencia a un WebPart control o a cualquier control de servidor que resida en una zona y que se ajuste a un GenericWebPart objeto en tiempo de ejecución.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.

EventoEvent DescripciónDescription
AuthorizeWebPart Se produce justo antes de que se agregue un control a una página para comprobar que está autorizado.Occurs just before a control is added to a page to verify that it is authorized.
ConnectionsActivated Se produce después de activar todas las conexiones en una página.Occurs after all the connections on a page have been activated.
ConnectionsActivating Se produce justo antes del proceso de activación de todas las conexiones en una página.Occurs just before the process of activating all the connections on a page.
DisplayModeChanged Se produce después de que cambie el modo de presentación actual de una página.Occurs after the current display mode of a page has changed.
DisplayModeChanging Se produce justo antes del proceso de cambiar el modo de presentación de una página.Occurs just before the process of changing a page's display mode.
SelectedWebPartChanged Se produce después de que se haya cancelado la selección de un control.Occurs after the selection of a control has been canceled.
SelectedWebPartChanging Se produce justo antes del proceso de cancelación de la selección de un control.Occurs just before the process of canceling the selection of a control.
WebPartAdded Se produce después de agregar un control a una zona.Occurs after a control has been added to a zone.
WebPartAdding Se produce justo antes del proceso de agregar un control a una zona.Occurs just before the process of adding a control to a zone.
WebPartClosed Se produce después de que un control se ha cerrado (quitado de una página).Occurs after a control has been closed (removed from a page).
WebPartClosing Se produce justo antes del proceso de cierre de un control.Occurs just before the process of closing a control.
WebPartDeleted Se produce después de que se elimine permanentemente una instancia de un control dinámico (una creada mediante programación o agregada a partir de un catálogo).Occurs after an instance of a dynamic control (one that was created programmatically or added from a catalog) has been permanently deleted.
WebPartDeleting Se produce justo antes del proceso de eliminación de un control dinámico.Occurs just before the process of deleting a dynamic control.
WebPartMoved Se produce después de que un control se mueve dentro de su zona o a otra zona.Occurs after a control has moved within its zone or to another zone.
WebPartMoving Se produce justo antes del proceso de mover un control.Occurs just before the process of moving a control.
WebPartsConnected Se produce después de que dos controles seleccionados para participar en una conexión hayan establecido la conexión.Occurs after two controls selected for participation in a connection have established the connection.
WebPartsConnecting Se produce justo antes del proceso de conexión de dos controles.Occurs just before the process of connecting two controls.
WebPartsDisconnected Se produce después de que se hayan desconectado dos controles conectados.Occurs after two connected controls have been disconnected.
WebPartsDisconnecting Se produce justo antes del proceso de desconectar dos controles.Occurs just before the process of disconnecting two controls.

El WebPartManager control tiene numerosos métodos para administrar elementos web páginas.The WebPartManager control has numerous methods for managing Web Parts pages. Un gran conjunto de los métodos, que no se enumeran aquí, son métodos cuyos nombres adoptan la forma de eneventName.A large set of the methods, not listed here, are methods whose names take the form of OnEventName. Normalmente, estos métodos generan su evento asociado y proporcionan el evento con un controlador de tipo WebPartEventHandler .These methods typically raise their associated event, and provide the event with a handler of type WebPartEventHandler. La mayoría de estos métodos pueden ser invalidados por desarrolladores que heredan de la WebPartManager clase.Most of these methods can be overridden by developers who inherit from the WebPartManager class. Además, los desarrolladores de páginas pueden proporcionar controladores personalizados para los eventos asociados a estos métodos.Also, page developers can provide custom handlers for the events associated with these methods. Por ejemplo, en el caso del WebPartAdded evento, un desarrollador de páginas podría agregar un OnWebPartAdded atributo al <asp:webpartmanager> elemento en el marcado de una página web y, a continuación, asignar un nombre de método personalizado al atributo para proporcionar un control personalizado para el evento.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. El atributo corresponde al OnWebPartAdded método y este patrón básico de control de eventos funciona para la mayoría de los eventos de elementos Web y sus métodos asociados.The attribute corresponds to the OnWebPartAdded method, and this basic pattern of event handling works for most Web Parts events and their associated methods.

Además, el WebPartManager control tiene métodos específicos de la tarea de administrar WebPart controles (y controles de servidor o de usuario usados como WebPart controles).In addition, the WebPartManager control has methods particular to the task of managing WebPart controls (and server or user controls used as WebPart controls). Estos métodos incluyen AddWebPart , AuthorizeWebPart , CloseWebPart , CopyWebPart , CreateWebPart , DeleteWebPart , DisconnectWebPart , BeginWebPartEditing , EndWebPartEditing , ExportWebPart , GetGenericWebPart , ImportWebPart , IsAuthorized y MoveWebPart .These methods include AddWebPart, AuthorizeWebPart, CloseWebPart, CopyWebPart, CreateWebPart, DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, EndWebPartEditing, ExportWebPart, GetGenericWebPart, ImportWebPart, IsAuthorized, and MoveWebPart.

Otro conjunto de métodos se especializa en las conexiones.Another set of methods is specialized for connections. Esto incluye métodos como ActivateConnections , BeginWebPartConnecting , CanConnectWebParts , ConnectWebParts , CreateAvailableTransformers , DisconnectWebPart , DisconnectWebParts , EndWebPartConnecting , GetConsumerConnectionPoints y GetProviderConnectionPoints .This includes methods such as ActivateConnections, BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPart, DisconnectWebParts, EndWebPartConnecting, GetConsumerConnectionPoints, and GetProviderConnectionPoints.

Por último, algunos WebPartManager métodos se centran en la funcionalidad de personalización.Finally, some WebPartManager methods focus on personalization functionality. Entre estas se incluyen CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save y SaveControlState.These include CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save, and SaveControlState.

Para obtener más información sobre otros WebPartManager métodos a los que se puede tener acceso a través de la Internals propiedad, vea la documentación de la WebPartManagerInternals clase.For more information on other WebPartManager methods that are accessible through the Internals property, see the documentation for the WebPartManagerInternals class.

Notas a los desarrolladores de herederos

El WebPartManager control está diseñado para extenderse.The WebPartManager control is designed to be extended. Dado que es tan importante para elementos web aplicaciones, si desea extender algún tipo o control específico en el conjunto de elementos web control, en muchos casos también debe extender la WebPartManager clase, porque es probable que tenga alguna propiedad o método que sea necesario para que el tipo personalizado funcione en el contexto de una aplicación elementos Web.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. La documentación de referencia de elementos web (vea System.Web.UI.WebControls.WebParts ), al explicar cómo extender un tipo de elementos Web, menciona con frecuencia lo que se debe hacer para ampliar WebPartManager también la clase o muestra cómo extenderlo en un ejemplo de código.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.

Constructores

WebPartManager()

Inicializa una nueva instancia de la clase WebPartManager.Initializes a new instance of the WebPartManager class.

Campos

BrowseDisplayMode

Representa el modo de presentación predeterminado para páginas que contienen controles de elementos Web.Represents the default display mode for pages that contain Web Parts controls. Este campo es de solo lectura.This field is read-only.

CatalogDisplayMode

Representa el modo de presentación utilizado para agregar controles de servidor de un catálogo de controles a una página Web.Represents the display mode used for adding server controls from a catalog of controls to a Web page. Este campo es de solo lectura.This field is read-only.

ConnectDisplayMode

Representa el modo de presentación que se utiliza para mostrar una interfaz de usuario especial que permite a los usuarios administrar las conexiones entre controles WebPart.Represents the display mode used for displaying a special user interface (UI) for users to manage connections between WebPart controls. Este campo es de solo lectura.This field is read-only.

DesignDisplayMode

Representa el modo de presentación utilizado para cambiar el diseño de páginas Web que contienen controles de elementos Web.Represents the display mode used for changing the layout of Web pages that contain Web Parts controls. Este campo es de solo lectura.This field is read-only.

EditDisplayMode

Representa el modo de presentación en el que los usuarios finales pueden editar y modificar controles de servidor.Represents the display mode in which end users can edit and modify server controls. Este campo es de solo lectura.This field is read-only.

Propiedades

Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Heredado de Control)
AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Heredado de Control)
AvailableTransformers

Obtiene una colección de objetos WebPartTransformer que están disponibles para su uso al crear conexiones de elementos Web entre los controles de servidor.Gets a collection of WebPartTransformer objects that are available for use in creating Web Parts connections between server controls.

BindingContainer

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

(Heredado de Control)
ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Heredado de Control)
ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Heredado de Control)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

(Heredado de Control)
CloseProviderWarning

Obtiene o establece una advertencia que se muestra cuando un usuario cierra un control que actúa como proveedor de otros controles en una conexión.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

Obtiene una referencia a la colección de todas las conexiones actuales en una página Web.Gets a reference to the collection of all current connections on a Web page.

Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

(Heredado de Control)
Controls

Obtiene la colección de todos los controles WebPart, de servidor o de usuario contenidos en zonas WebPartZoneBase de una página Web y administrados por el control 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

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Heredado de Control)
DeleteWarning

Obtiene o establece un mensaje de advertencia personalizado que se muestra a los usuarios finales cuando eliminan un control.Gets or sets a custom warning message displayed to end users when they delete a control.

DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Heredado de Control)
DisplayMode

Obtiene o establece el modo de presentación activo para una página Web que contiene controles de elementos Web.Gets or sets the active display mode for a Web page that contains Web Parts controls.

DisplayModes

Obtiene una colección de sólo lectura de todos los modos de presentación asociados a un control WebPartManager.Gets a read-only collection of all display modes that are associated with a WebPartManager control.

DynamicConnections

Obtiene la colección de todas las conexiones dinámicas que actualmente existen en una página Web.Gets the collection of all dynamic connections that currently exist on a Web page.

EnableClientScript

Obtiene o establece un valor que determina si el scripting de cliente está habilitado en la página Web que contiene un control WebPartManager.Gets or sets a value that determines whether client-side scripting is enabled on the Web page that contains a WebPartManager control.

EnableTheming

Obtiene un valor que indica que el uso de temas está habilitado en una página Web.Gets a value indicating that the use of themes is enabled on a Web page.

EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.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.

(Heredado de Control)
Events

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de sólo lectura.This property is read-only.

(Heredado de Control)
ExportSensitiveDataWarning

Obtiene o establece el texto de un mensaje de advertencia que se muestra cuando un usuario intenta exportar datos de estado confidenciales desde un control 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

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Heredado de Control)
ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Heredado de Control)
IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

(Heredado de Control)
Internals

Obtiene una referencia a la clase WebPartManagerInternals, que se utiliza para combinar y separar un conjunto de métodos implementados actualmente en la clase WebPartManager y son muy útiles para los desarrolladores de controles.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

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Heredado de Control)
IsCustomPersonalizationStateDirty

Obtiene un valor que indica si se han realizado cambios de personalización que afectan a detalles de personalización de nivel de página administrados por el control WebPartManager.Gets a value that indicates whether personalization changes have been made that affect page-level personalization details controlled by the WebPartManager control.

IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Heredado de Control)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this control.

(Heredado de Control)
LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Heredado de Control)
MediumPermissionSet

Obtiene un objeto PermissionSet que solo permite el permiso Execution y el permiso Medium.Gets a PermissionSet object that allows only Execution permission and Medium permission.

MinimalPermissionSet

Obtiene un objeto PermissionSet que solo permite el permiso Execution y el permiso Minimal.Gets a PermissionSet object that allows only Execution permission and Minimal permission.

NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad 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.

(Heredado de Control)
Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Heredado de Control)
Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

(Heredado de Control)
Personalization

Obtiene una referencia a un objeto que contiene los datos de personalización para una página Web.Gets a reference to an object that contains personalization data for a Web page.

RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Heredado de Control)
SelectedWebPart

Obtiene una referencia a un control WebPart u otro control de servidor que está seleccionado actualmente para edición o para crear una conexión con otro control.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

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Heredado de Control)
SkinID

Obtiene o establece una cadena vacía ("") para que no se pueda aplicar ninguna máscara al control WebPartManager.Gets or sets an empty string ("") so that no skin can be applied to the WebPartManager control.

StaticConnections

Obtiene una referencia a la colección de todos los objetos WebPartConnection de una página Web que se definen como conexiones estáticas.Gets a reference to the collection of all WebPartConnection objects on a Web page that are defined as static connections.

SupportedDisplayModes

Obtiene una colección de sólo lectura de todos los modos de presentación que están disponibles en una página Web determinada.Gets a read-only collection of all display modes that are available on a particular Web page.

TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Heredado de Control)
UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Heredado de Control)
ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Heredado de Control)
ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.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.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Heredado de Control)
Visible

Obtiene un valor que permite que los controles secundarios sean visibles.Gets a value that enables child controls to be visible.

WebParts

Obtiene una referencia a todos los controles WebPart cuyo seguimiento efectúa el control WebPartManager en una página Web.Gets a reference to all WebPart controls tracked by the WebPartManager control on a Web page.

Zones

Obtiene una referencia a una colección de todas las zonas WebPartZoneBase de una página Web.Gets a reference to a collection of all the WebPartZoneBase zones on a Web page.

Métodos

ActivateConnections()

Activa todas las conexiones de una página Web que están actualmente inactivas.Makes active all connections on a Web page that are currently inactive.

AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Heredado de Control)
AddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Heredado de Control)
AddWebPart(WebPart, WebPartZoneBase, Int32)

Proporciona el método de programación estándar para agregar controles WebPart a una página Web.Provides the standard programmatic method for adding WebPart controls to a Web page.

ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.Applies the style properties defined in the page style sheet to the control.

(Heredado de Control)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

(Heredado de Control)
BeginWebPartConnecting(WebPart)

Inicia el proceso de conectar dos controles WebPart.Starts the process of connecting two WebPart controls.

BeginWebPartEditing(WebPart)

Inicia el proceso de editar un control WebPart.Starts the process of editing a WebPart control.

BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Heredado de Control)
CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Comprueba los controles WebPart que participarán en una conexión para determinar si son capaces de conectarse, cuando los controles consumidor y proveedor tienen interfaces compatibles y no se necesita un objeto 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)

Comprueba los controles WebPart que van a participar en una conexión para determinar si pueden conectarse y utiliza un objeto WebPartTransformer para crear la conexión entre un consumidor y un proveedor incompatibles.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()

Comprueba las funciones del explorador que realiza la solicitud y el valor de la propiedad EnableClientScript para determinar si se va a representar script de cliente.Checks the capabilities of the browser making the request, and the value of the EnableClientScript property, to determine whether to render client script.

ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.Sets the cached ClientID value to null.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

(Heredado de Control)
ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Heredado de Control)
CloseWebPart(WebPart)

Cierra un control WebPart de manera que no se representa en una página Web, pero se puede volver a abrir.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)

Crea una conexión entre dos controles WebPart o GenericWebPart utilizando sólo las referencias a los controles y sus objetos ConnectionPoint especificados.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)

Crea una conexión entre dos controles WebPart o GenericWebPart utilizando las referencias a los controles, sus objetos ConnectionPoint especificados y un objeto 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)

Las utiliza el conjunto de controles de elementos Web para crear una copia de un control WebPart o un control de servidor para el fin de agregar el control a una página Web.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()

Crea un conjunto de transformadores especificados en el archivo de configuración de un sitio Web y los agrega a la colección de transformadores a los que hace referencia la propiedad 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()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.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.

(Heredado de Control)
CreateControlCollection()

Devuelve la colección de todos los controles administrados por el control WebPartManager en una página Web.Returns the collection of all controls that are managed by the WebPartManager control on a Web page. Esta clase no puede heredarse.This class cannot be inherited.

CreateDisplayModes()

Crea el conjunto de todos los posibles modos de presentación para una aplicación de elementos Web.Creates the set of all possible display modes for a Web Parts application.

CreateDynamicConnectionID()

Obtiene un valor único que sirve como id. de una conexión dinámica.Gets a unique value to serve as an ID for a dynamic connection.

CreateDynamicWebPartID(Type)

Genera un id. único para un control WebPart dinámico.Generates a unique ID for a dynamic WebPart control.

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

Crea un control especial que se inserta en una página y se muestra a los usuarios finales cuando, por algún motivo, se produce un error al intentar cargar o crear un control 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()

Devuelve un objeto de personalización que contiene los datos de personalización de un usuario para la página Web actual.Returns a personalization object to contain a user's personalization data for the current Web page.

CreateWebPart(Control)

Ajusta un control de servidor que no es un control WebPart con un objeto GenericWebPart para que el control pueda tener la funcionalidad de los elementos Web.Wraps a server control that is not a WebPart control with a GenericWebPart object, so that the control can have Web Parts functionality.

DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.Binds a data source to the invoked server control and all its child controls.

(Heredado de Control)
DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

(Heredado de Control)
DeleteWebPart(WebPart)

Quita permanentemente una instancia dinámica de un control WebPart de una página Web.Permanently removes a dynamic instance of a WebPart control from a Web page.

DisconnectWebPart(WebPart)

Quita un control WebPart o control de servidor que se cierra o elimina de cualquier conexión en la que esté participando.Removes a WebPart or server control that is being closed or deleted from any connections it is participating in.

DisconnectWebParts(WebPartConnection)

Realiza el proceso de desconectar controles de servidor que se conectan en una página Web.Carries out the process of disconnecting server controls that are connected on a Web page.

Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.Enables a server control to perform final clean up before it is released from memory.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Heredado de Control)
EndWebPartConnecting()

Finaliza el proceso de conectar un control WebPart a otro control.Completes the process of connecting a WebPart control to another control.

EndWebPartEditing()

Completa el proceso de editar un control WebPart.Completes the process of editing a WebPart control.

EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Heredado de Control)
EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
ExportWebPart(WebPart, XmlWriter)

Crea un archivo de descripción XML que contiene los datos de estado y de propiedades correspondientes a un control de servidor.Creates an XML description file that contains state and property data for a server control.

FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

(Heredado de Control)
FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda.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. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

(Heredado de Control)
Focus()

Se reemplaza para evitar que el foco se establezca en el control WebPartManager, porque no tiene ninguna interfaz de usuario.Overridden to prevent focus from ever being set on the WebPartManager control, because it has no user interface (UI).

GetConsumerConnectionPoints(WebPart)

Recupera la colección de objetos ConsumerConnectionPoint que pueden actuar como puntos de conexión de un control de servidor que, a su vez, actúa como consumidor en una conexión de elementos Web.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)

Recupera una referencia a la instancia actual del control WebPartManager en una página.Retrieves a reference to the current instance of the WebPartManager control on a page.

GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

(Heredado de Control)
GetDisplayTitle(WebPart)

Obtiene una cadena que contiene el valor de la propiedad DisplayTitle en un control WebPart.Gets a string containing the value for the DisplayTitle property of a WebPart control.

GetExportUrl(WebPart)

Obtiene la ruta de acceso virtual relativa y la cadena de consulta que forman parte de la solicitud cuando un usuario intenta exportar un control 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)

Obtiene una referencia a la instancia del control GenericWebPart que contiene un control de servidor.Gets a reference to the instance of the GenericWebPart control that contains a server control.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetProviderConnectionPoints(WebPart)

Recupera la colección de objetos ProviderConnectionPoint que pueden actuar como puntos de conexión de un control de servidor que, a su vez, actúa como proveedor en una conexión de elementos Web.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)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Heredado de Control)
GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Heredado de Control)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Heredado de Control)
HasControls()

Determina si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Heredado de Control)
HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

(Heredado de Control)
ImportWebPart(XmlReader, String)

Importa un archivo de descripción XML que contiene datos de estado y de propiedades de un control WebPart y aplica los datos al control.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)

Realiza los pasos finales para determinar si un control tiene autorización para ser agregado a una página.Carries out the final steps in determining whether a control is authorized to be added to a page.

IsAuthorized(WebPart)

Realiza los pasos iniciales para determinar si un control tiene autorización para ser agregado a una página.Carries out the initial steps in determining whether a control is authorized to be added to a page.

IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

(Heredado de Control)
LoadControlState(Object)

Carga los datos de estado del control que se guardaron de una solicitud de página anterior y tienen que restaurarse en una solicitud subsiguiente.Loads control state data that was saved from a previous page request, and needs to be restored on a subsequent request.

LoadCustomPersonalizationState(PersonalizationDictionary)

Almacena los datos de personalización a medida que se ha pasado el control WebPartManager de los objetos de personalización que se utilizará más adelante durante el proceso de inicialización.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)

Restaura la información de estado de vista de una solicitud de página anterior guardada por el método SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(Heredado de Control)
MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Heredado de Control)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MoveWebPart(WebPart, WebPartZoneBase, Int32)

Mueve un control WebPart o un control de servidor de una zona WebPartZoneBase a otra o a una posición nueva dentro de la misma zona.Moves a WebPart or server control from one WebPartZoneBase zone to another, or to a new position within the same zone.

OnAuthorizeWebPart(WebPartAuthorizationEventArgs)

Produce el evento AuthorizeWebPart e invoca un controlador para el evento, si existe uno.Raises the AuthorizeWebPart event and invokes a handler for the event, if one exists.

OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Heredado de Control)
OnConnectionsActivated(EventArgs)

Produce el evento ConnectionsActivated para indicar que una página y sus controles se han cargado, y que las conexiones de la página se han activado para empezar a compartir datos.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)

Produce el evento ConnectionsActivating para indicar que una página y sus controles se han cargado, y que el proceso de activar las conexiones puede comenzar.Raises the ConnectionsActivating event to indicate that a page and its controls have loaded, and the process of activating connections can begin.

OnDataBinding(EventArgs)

Genera el evento DataBinding.Raises the DataBinding event.

(Heredado de Control)
OnDisplayModeChanged(WebPartDisplayModeEventArgs)

Produce el evento DisplayModeChanged para indicar que el control WebPartManager ha completado el proceso de cambiar de un modo de presentación a otro en una página Web.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)

Produce el evento DisplayModeChanging para indicar que el control WebPartManager está en el proceso de cambiar de un modo de presentación a otro en una página Web.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)

Provoca el evento Init, que es el primer evento en el ciclo de vida del control WebPartManager.Raises the Init event, which is the first event in the WebPartManager control life cycle.

OnLoad(EventArgs)

Genera el evento Load.Raises the Load event.

(Heredado de Control)
OnPreRender(EventArgs)

Produce el evento PreRender, que tiene lugar justo antes de que se represente un control WebPartManager en una página Web.Raises the PreRender event, which occurs just before a WebPartManager control is rendered on a Web page.

OnSelectedWebPartChanged(WebPartEventArgs)

Produce el evento SelectedWebPartChanged, que tiene lugar después de que se active o se desactive la selección de un control WebPart.Raises the SelectedWebPartChanged event, which occurs after a WebPart control has either been newly selected or had its selection cleared.

OnSelectedWebPartChanging(WebPartCancelEventArgs)

Produce el evento SelectedWebPartChanging, que tiene lugar durante el proceso de cambiar el control WebPart que está activado actualmente.Raises the SelectedWebPartChanging event, which occurs during the process of changing which WebPart control is currently selected.

OnUnload(EventArgs)

Produce el evento base Unload y quita la instancia de WebPartManager de una página Web.Raises the base Unload event and removes the WebPartManager instance from a Web page.

OnWebPartAdded(WebPartEventArgs)

Produce el evento WebPartAdded, que tiene lugar después de que un control WebPart se ha agregado a una página.Raises the WebPartAdded event, which occurs after a WebPart control has been added to a page.

OnWebPartAdding(WebPartAddingEventArgs)

Produce el evento WebPartAdding, que tiene lugar durante el proceso de agregar un control WebPart (o un control de servidor o de usuario) a una zona 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)

Produce el evento WebPartClosed para señalar que un control se ha quitado de una página.Raises the WebPartClosed event to signal that a control has been removed from a page.

OnWebPartClosing(WebPartCancelEventArgs)

Produce el evento WebPartClosing, que tiene lugar durante el proceso de un control WebPart o un control de servidor que se quita de una página.Raises the WebPartClosing event, which occurs during the process of a WebPart or server control being removed from a page.

OnWebPartDeleted(WebPartEventArgs)

Produce el evento WebPartDeleted, que tiene lugar después de que un control WebPart se ha eliminado permanentemente de una página.Raises the WebPartDeleted event, which occurs after a WebPart control has been permanently deleted from a page.

OnWebPartDeleting(WebPartCancelEventArgs)

Produce el evento WebPartDeleting, que indica que un control WebPart dinámico (o un control de usuario o de servidor incluido en una zona WebPartZoneBase) está en el proceso de eliminarse.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)

Produce el evento WebPartMoved, que tiene lugar después de que un control WebPart se ha movido a una ubicación diferente en una página.Raises the WebPartMoved event, which occurs after a WebPart control has been moved to a different location on a page.

OnWebPartMoving(WebPartMovingEventArgs)

Produce el evento WebPartMoving, que indica que un control WebPart o un control de usuario o de servidor incluido en una zona WebPartZoneBase está en el proceso de moverse.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)

Produce el evento WebPartsConnected, que tiene lugar después de que se ha establecido una conexión entre los controles WebPart.Raises the WebPartsConnected event, which occurs after a connection has been established between WebPart controls.

OnWebPartsConnecting(WebPartConnectionsCancelEventArgs)

Produce el evento WebPartsConnecting, que tiene lugar durante el proceso de establecer una conexión entre dos controles WebPart o dos controles de servidor o de usuario en una zona 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)

Produce el evento WebPartsDisconnected, que tiene lugar después de que haya finalizado una conexión entre controles WebPart.Raises the WebPartsDisconnected event, which occurs after a connection between WebPart controls has ended.

OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)

Produce el evento WebPartsDisconnecting, que indica que dos controles WebPart o dos controles de usuario o de servidor incluidos en una zona WebPartZoneBase están en el proceso de finalizar una conexión.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)

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.Assigns any sources of the event and its information to the control's parent.

(Heredado de Control)
RegisterClientScript()

Permite que el control WebPartManager emita script de cliente que se utiliza para las distintas características de personalización, como arrastrar controles WebPart en una página Web.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)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Heredado de Control)
Render(HtmlTextWriter)

Se reemplaza para evitar que el control WebPartManager represente cualquier contenido.Overridden to prevent the WebPartManager control from rendering any content.

RenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Heredado de Control)
RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Heredado de Control)
ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

(Heredado de Control)
SaveControlState()

Guarda los datos de estado para el control WebPartManager a fin de que los datos se puedan restaurar en una solicitud futura a la página Web que contenga el control.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)

Guarda los datos de estado de personalización personalizados que mantiene el control WebPartManager, para que se puedan volver a cargar cada vez que se vuelva a cargar la página.Saves custom personalization state data maintained by the WebPartManager control, so that this data can be reloaded whenever the page is reloaded.

SaveViewState()

Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Heredado de Control)
SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

(Heredado de Control)
SetPersonalizationDirty()

Establece un marcador que muestra que los datos de personalización del control WebPartManager personalizado han cambiado.Sets a flag indicating that custom personalization data for the WebPartManager control has changed.

SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.Assigns an event handler delegate to render the server control and its content into its parent control.

(Heredado de Control)
SetSelectedWebPart(WebPart)

Establece el valor de la propiedad SelectedWebPart igual al control WebPart o control de servidor actualmente seleccionado.Sets the SelectedWebPart property value equal to the currently selected WebPart or server control.

SetTraceData(Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Heredado de Control)
SetTraceData(Object, Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TrackViewState()

Aplica los datos de estado de personalización al control WebPartManager y llama al método base para permitir el seguimiento de los cambios a los datos de estado de la vista en el control.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.

Eventos

AuthorizeWebPart

Se produce cuando se llama al método IsAuthorized para determinar si se puede agregar un control WebPart o un control de servidor a una página.Occurs when the IsAuthorized method is called to determine whether a WebPart or server control can be added to a page.

ConnectionsActivated

Se produce después de que todas las conexiones de elementos Web actuales de una página están conectados y, además, han empezado a compartir activamente datos entre los controles consumidor y proveedor que participan en cada conexión.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

Se produce durante el proceso de activar todas las conexiones de elementos Web establecidas en una página Web.Occurs during the process of activating all the established Web Parts connections on a Web page.

DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Heredado de Control)
DisplayModeChanged

Se produce después de que el modo de presentación actual en una página de elementos Web ha cambiado.Occurs after the current display mode on a Web Parts page has changed.

DisplayModeChanging

Se produce después de que un usuario haga clic en una página Web en un verbo que comienza el proceso de cambiar a un modo de presentación diferente.Occurs after a user clicks a verb on a Web page that begins the process of changing to a different display mode.

Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página 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.

(Heredado de Control)
Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Heredado de Control)
Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Heredado de Control)
PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Heredado de Control)
SelectedWebPartChanged

Se produce después de que la selección de un control WebPart ha cambiado y se ha movido a otro control en una página Web.Occurs after the selection of one WebPart control has changed and moved to another control on a Web page.

SelectedWebPartChanging

Se produce durante el proceso de cambiar qué control WebPart o control de servidor está seleccionado actualmente en una página Web.Occurs during the process of changing which WebPart or server control is currently selected on a Web page.

Unload

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Heredado de Control)
WebPartAdded

Se produce después de agregar un control WebPart dinámico u otro control de servidor a una zona WebPartZoneBase para indicar que el control se agregó correctamente.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

Aparece durante el proceso de agregar un control WebPart dinámico u otro control de servidor a una zona WebPartZoneBase.Occurs during the process of adding a dynamic WebPart or other server control to a WebPartZoneBase zone.

WebPartClosed

Aparece cuando un control WebPart (o un control de usuario o de servidor) se quita de una página.Occurs when a WebPart control (or server or user control) is removed from a page.

WebPartClosing

Aparece durante el proceso de quitar un control WebPart (o un control de usuario o de servidor) de una página.Occurs during the process of removing a WebPart control (or server or user control) from a page.

WebPartDeleted

Se produce después de eliminar un control WebPart u otro control de servidor de una zona WebPartZoneBase.Occurs after a WebPart or other server control has been deleted from a WebPartZoneBase zone.

WebPartDeleting

Aparece durante el proceso de eliminar permanentemente una instancia de un control WebPart dinámico u otro control de servidor de una zona WebPartZoneBase.Occurs during the process of permanently deleting an instance of a dynamic WebPart or other server control from a WebPartZoneBase zone.

WebPartMoved

Se produce después de mover un control WebPart o un control de servidor a una ubicación diferente en una página Web.Occurs after a WebPart or server control has been moved to a different location on a Web page.

WebPartMoving

Se produce durante el proceso de mover un control WebPart u otro control de servidor contenido en una zona WebPartZoneBase.Occurs during the process of moving a WebPart or other server control that is contained in a WebPartZoneBase zone.

WebPartsConnected

Se produce después de establecer una conexión concreta entre controles WebPart (o controles de servidor o de usuario).Occurs after a specific connection has been established between WebPart controls (or server or user controls).

WebPartsConnecting

Aparece durante el proceso de crear una conexión entre controles WebPart (o controles de usuario o de servidor colocados en una zona WebPartZoneBase).Occurs during the process of creating a connection between WebPart controls (or server or user controls placed in a WebPartZoneBase zone).

WebPartsDisconnected

Se produce después de finalizar una conexión entre dos controles WebPart o controles de servidor.Occurs after a connection between two WebPart or server controls has been terminated.

WebPartsDisconnecting

Se produce durante el proceso de finalizar la conexión entre controles WebPart o controles de servidor previamente conectados.Occurs during the process of ending the connection between previously connected WebPart or server controls.

Implementaciones de interfaz explícitas

IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obtener una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para obtener una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.For a description of this member, see HasDataBindings.

(Heredado de Control)
IExpressionsAccessor.Expressions

Para obtener una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Heredado de Control)
IPersonalizable.IsDirty

Obtiene un valor que indica si los datos de estado de personalización administrados por el control WebPartManager han cambiado en una página Web.Gets a value that indicates whether custom personalization state data managed by the WebPartManager control has changed on a Web page.

IPersonalizable.Load(PersonalizationDictionary)

Devuelve los datos de estado de personalización personalizados y anteriormente cargados que deben cargarse en el control WebPartManager.Returns previously saved custom personalization state data that needs to be loaded to the WebPartManager control.

IPersonalizable.Save(PersonalizationDictionary)

Guarda los datos de estado de personalización propios que son administrados por el control WebPartManager.Saves custom personalization state data that is managed by the WebPartManager control.

Métodos de extensión

FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Obtiene la colección de los valores predeterminados para el control de datos especificado.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Obtiene los metadatos de la tabla para el control de datos especificado.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Establece los metadatos de la tabla para el control de datos especificado.Sets the table metadata for the specified data control.

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

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Determina si están disponibles los metadatos de la tabla.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

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

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

Se aplica a

Consulte también