Compartir a través de


GenericWebPart Clase

Definición

Ajusta los controles de servidor que no son controles WebPart para que puedan aparecer y comportarse como verdaderos controles WebPart en tiempo de ejecución.

public ref class GenericWebPart : System::Web::UI::WebControls::WebParts::WebPart
public class GenericWebPart : System.Web.UI.WebControls.WebParts.WebPart
type GenericWebPart = class
    inherit WebPart
Public Class GenericWebPart
Inherits WebPart
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra cómo el GenericWebPart control ajusta automáticamente un control de servidor que no es un WebPart control en tiempo de ejecución.

La primera parte del ejemplo de código contiene una página de elementos web con dos WebPartZone controles. Dentro de cada zona es un control de servidor estándar ASP.NET. Dado que los controles están en una WebPartZone zona, se encapsularán automáticamente con un GenericWebPart control cuando se compile la página. Por lo tanto, puede declarar WebPart propiedades de clase en estos controles. Después de cargar la página en un explorador, si hace clic en el botón Mostrar todos los valores de propiedad , los detalles de cada control se muestran en una etiqueta. Para mostrar cómo funciona el GenericWebPart control, el Calendar control de la primera zona tiene algunas de las GenericWebPart propiedades establecidas en el marcado declarativo de la página .aspx, mientras que el BulletedList control no. Después de cargar la página, observe las diferencias en los valores de propiedad de los dos controles y que ambos tienen un control primario GenericWebPart .

<%@ Page Language="C#" 
  Codefile="genericwebpart.cs" 
  Inherits="genericwebpart_sample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>
<%@ Page Language="vb" 
  Codefile="genericwebpart.vb" 
  Inherits="genericwebpart_sample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>

La segunda parte del ejemplo de código muestra una clase parcial que tiene acceso a algunas propiedades del GenericWebPart control mediante programación. Observe que en el Page_Load método , el GetGenericWebPart método se usa para recuperar la instancia en tiempo de ejecución del GenericWebPart control que encapsula un control de servidor. Este enfoque para obtener una referencia al control primario GenericWebPart le permite trabajar mediante programación con un servidor normal o un control de usuario como si fuera un WebPart control en tiempo de ejecución.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class genericwebpart_sample : System.Web.UI.Page
{
  GenericWebPart calendarPart;
  GenericWebPart listPart;

  protected void Page_Load(Object sender, EventArgs e)
  {
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1);
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1);

    if (!IsPostBack)
    {
      Label2.Text = String.Empty;
      Label3.Text = String.Empty;
    }
  }

  protected void Button1_Click(object sender, EventArgs e)
  {

    Label2.Text =
      @"<h3>Calendar GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + calendarPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + calendarPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + calendarPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + calendarPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + calendarPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + calendarPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + calendarPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + calendarPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + calendarPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + calendarPart.Parent.ID;

    Label3.Text =
      @"<h3>BulletedList GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + listPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + listPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + listPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + listPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + listPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + listPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + listPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + listPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + listPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + listPart.Parent.ID;
  }
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

Partial Public Class genericwebpart_sample

  Inherits System.Web.UI.Page

  Private calendarPart As GenericWebPart
  Private listPart As GenericWebPart

  Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1)
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1)

    If Not IsPostBack Then
      Label2.Text = String.Empty
      Label3.Text = String.Empty
    End If

  End Sub


  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

    Label2.Text = _
      "<h3>Calendar GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & calendarPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & calendarPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & calendarPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & calendarPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & calendarPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & calendarPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & calendarPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & calendarPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & calendarPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & calendarPart.Parent.ID

    Label3.Text = _
      "<h3>BulletedList GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & listPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & listPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & listPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & listPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & listPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & listPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & listPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & listPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & listPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & listPart.Parent.ID
  End Sub

End Class

Comentarios

El GenericWebPart control existe para proporcionar un contenedor en tiempo de ejecución para los controles de servidor que no WebPart son controles, de modo que dichos controles se puedan usar en aplicaciones y páginas de elementos web. Cuando los desarrolladores agregan controles de servidor, como controles de usuario, ASP.NET controles de servidor o controles personalizados existentes, WebPartZoneBase el GenericWebPart control encapsula automáticamente los controles de servidor en tiempo de ejecución para que puedan mostrar la misma funcionalidad que los controles verdaderos WebPart .

En la tabla siguiente se comparan y contrastan GenericWebPart los controles y WebPart los controles.

Control GenericWebPart Control WebPart
Existe para equipar controles de servidor que no WebPart son controles con funcionalidad de elementos web, de modo que cualquier ASP.NET, personalizado o control de usuario pueda participar en aplicaciones de elementos web. Existe para crear controles ASP.NET personalizados que tengan integrada la funcionalidad nativa de elementos web. Esto incluye las funcionalidades de personalización, conexiones, importación y exportación y arrastrar y colocar.
Nunca se declara en el marcado de una página. Solo existe para encapsular los controles de servidor en tiempo de ejecución y para proporcionar al control ajustado (o control secundario) toda la funcionalidad de un WebPart control. Se puede declarar en el marcado de una página en tiempo de diseño, como un control de servidor ASP.NET, excepto que se declara en una WebPartZoneBase zona.
Incluye e integra su control secundario en el proceso de personalización de elementos web para que pueda actuar como un control verdadero WebPart . Esto ocurre automáticamente, lo que facilita a los desarrolladores el uso de controles de servidor y controles de usuario en aplicaciones de elementos web. Se incluye automáticamente en el proceso de personalización de elementos web.
Se puede tener acceso mediante programación en tiempo de ejecución (mediante el GetGenericWebPart método y pasarlo al control de servidor secundario), como un control true WebPart o un control estándar ASP.NET. Se puede acceder mediante programación en tiempo de ejecución, como un control estándar de ASP.NET.

Los usuarios se benefician del GenericWebPart control porque proporciona una experiencia de usuario coherente. Cualquier control de servidor se puede hacer para funcionar como un WebPart control y tendrá los mismos elementos coherentes de la interfaz de usuario (UI), como verbos, iconos, un título y un encabezado. Los desarrolladores se benefician del GenericWebPart control porque les permite reutilizar los controles de usuario y los controles de servidor existentes en las aplicaciones de elementos web.

Nota

Al crear páginas de elementos web, no es necesario hacer nada para permitir que un control de usuario existente o un control personalizado se encapsulan con el GenericWebPart control . Basta con agregar el servidor o el control de usuario a una WebPartZoneBase zona, ya sea mediante programación o declarandolo en el marcado de la página, y el conjunto de controles de elementos web ajusta automáticamente el control con un GenericWebPart objeto en tiempo de ejecución.

Dado que los controles de servidor que se colocan en WebPartZoneBase zonas se encapsulan con un GenericWebPart control en tiempo de ejecución, los desarrolladores pueden usar controles de usuario y servidor normales exactamente como si fueran WebPart controles. Tenga en cuenta que, si declara controles personalizados que heredan de la clase base Control dentro de , WebPartZoneestos controles no pueden admitir el uso de las propiedades intrínsecas WebPart . Por lo tanto, no se pueden declarar las IWebPart propiedades en dichos controles, incluidas las propiedades, como la Title propiedad y la Description propiedad . Por el contrario, otros tipos de controles de servidor (como WebPart controles, controles de usuario y controles personalizados que heredan de WebControl) pueden declarar estas propiedades, ya que admiten el uso de propiedades expando.

Las propiedades expando son realmente cadenas que se pueden agregar a una clase dinámicamente como una propiedad, mediante la IAttributeAccessor interfaz . Los controles que implementan esta interfaz, incluida la WebControl clase y sus elementos secundarios, pueden usar propiedades expando. Dado que la clase base Control no admite propiedades expando, cuando un control personalizado que hereda de la Control clase se coloca en un WebPartZone control y se ajusta con un GenericWebPart control en tiempo de ejecución, el conjunto de controles de elementos web no puede agregar dinámicamente las propiedades intrínsecas IWebPart al control personalizado. Tiene dos opciones en este caso. Puede usar el control personalizado sin las IWebPart propiedades o puede implementar la IWebPart interfaz en el control personalizado, lo que le permite usar las propiedades.

Como ejemplo de cómo los controles que heredan de WebControl pueden usar las IWebPart propiedades, si declara un control de ASP.NET Calendar en el marcado de una página (dentro de una WebPartZoneBase zona) en tiempo de diseño, aunque este control no herede de la WebPart clase y no contenga WebPart miembros de forma nativa, puede tratarlo exactamente como un WebPart control. Puede declarar WebPart propiedades en el control de calendario, como Title, Descriptiony otros. En tiempo de ejecución, puede usar el GetGenericWebPart método , que devuelve el GenericWebPart control que ajusta dinámicamente el control de calendario y trabaja con él mediante programación exactamente como lo haría con un WebPart control, con acceso a todas las mismas propiedades, eventos y métodos.

El GenericWebPart control tiene una propiedad crítica que permite acceder a su control de servidor subyacente: la ChildControl propiedad . Esta propiedad permite a los desarrolladores acceder mediante programación al control de servidor. El ChildControl control también usa la WebPartManager propiedad para acceder a los datos de personalización del control secundario y para realizar la autorización, si se establece la AuthorizationFilter propiedad .

El GenericWebPart control tiene otras propiedades, todas las cuales invalidan las propiedades heredadas de la clase base WebPart . Como se ha indicado, puede usar estas propiedades con cualquier control secundario, para que pueda comportarse como un WebPart control. Una propiedad importante es la ExportMode propiedad ; determina si todas las propiedades exportables, o solo las marcadas como no confidenciales, se pueden exportar. Las propiedades orientadas a la interfaz de usuario heredadas de la WebPart clase , como CatalogIconImageUrl, Description, Height, Title, TitleUrl, y Width, se pueden establecer en el marcado declarativo para cualquier control de servidor que se coloque en una WebPartZoneBase zona.

Los métodos importantes de la GenericWebPart clase incluyen el CreateControlCollection método , que crea la colección de controles (incluidos los controles secundarios) asociados a un GenericWebPart control y el Render método , que delega toda la representación en los controles secundarios ajustados. Los constructores de la GenericWebPart clase están protegidos y están diseñados para uso interno o para escenarios de extensibilidad.

Hay algunas conclusiones útiles adicionales para trabajar con GenericWebPart controles. Si desea establecer valores predeterminados para las propiedades invalidadas en la GenericWebPart clase , el control de usuario o el control de servidor personalizado pueden implementar las IWebPart interfaces e IWebActionable e invalidar sus miembros. En tiempo de ejecución, el GenericWebPart control obtendrá sus valores para las propiedades implementadas del control secundario que implementa las interfaces. Si el control define cualquiera de sus propiedades como personalizables (mediante el Personalizable atributo de metadatos), el GenericWebPart control habilita automáticamente esas propiedades para la personalización en tiempo de ejecución, al igual que las propiedades personalizables en un WebPart control.

Si desea proporcionar características de edición de elementos web para el control, puede implementar la IWebEditable interfaz . En tiempo de ejecución, cuando se llama al CreateEditorParts método , el GenericWebPart código del control para la WebBrowsableObject propiedad llamará a la misma propiedad en el control secundario y usará la implementación del control secundario para crear controles personalizados EditorPart asociados.

Notas a los desarrolladores de herederos

Hay pocas ocasiones en las que es necesario heredar de la GenericWebPart clase . Un caso de este tipo sería si un desarrollador quiere implementar alguna acción personalizada en el constructor cuando se crea un GenericWebPart control. Por ejemplo, es posible que quiera almacenar el control secundario en algún lugar distinto de la colección de controles dentro de la GenericWebPart clase . Si hereda de la GenericWebPart clase , también debe heredar de la WebPartManager clase e invalidar su CreateWebPart(Control) método para habilitarlo para crear el control personalizado.

Constructores

GenericWebPart(Control)

Inicializa una nueva instancia de un control GenericWebPart pasando en una referencia a un control que se convierte en el control secundario.

Propiedades

AccessKey

Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web.

(Heredado de WebControl)
Adapter

Obtiene el adaptador específico del explorador para el control.

(Heredado de Control)
AllowClose

Obtiene o establece un valor que indica si un usuario final puede cerrar un control WebPart en una página Web.

(Heredado de WebPart)
AllowConnect

Obtiene o establece un valor que indica si el control WebPart permite a otros controles establecer conexiones con él.

(Heredado de WebPart)
AllowEdit

Obtiene o establece un valor que indica si un usuario final puede modificar un control WebPart a través de la interfaz de usuario (IU) proporcionada por uno o más controles EditorPart.

(Heredado de WebPart)
AllowHide

Obtiene o establece un valor que indica si los usuarios finales pueden ocultar o no un control WebPart.

(Heredado de WebPart)
AllowMinimize

Obtiene o establece un valor que indica si los usuarios finales pueden minimizar un control WebPart.

(Heredado de WebPart)
AllowZoneChange

Obtiene o establece un valor que indica si un usuario puede mover un control WebPart entre las zonas WebPartZoneBase.

(Heredado de WebPart)
AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.

(Heredado de Control)
Attributes

Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control.

(Heredado de WebControl)
AuthorizationFilter

Obtiene o establece una cadena arbitraria para determinar si se permite agregar un control WebPart a una página.

(Heredado de WebPart)
BackColor

Obtiene o establece el color de fondo del control de servidor web.

(Heredado de WebControl)
BackImageUrl

Obtiene o establece la dirección URL de la imagen de fondo para el control del panel.

(Heredado de Panel)
BindingContainer

Obtiene el control que contiene el enlace de datos de este control.

(Heredado de Control)
BorderColor

Obtiene o establece el color de borde del control Web.

(Heredado de WebControl)
BorderStyle

Obtiene o establece el estilo del borde del control de servidor web.

(Heredado de WebControl)
BorderWidth

Obtiene o establece el ancho del borde del control de servidor web.

(Heredado de WebControl)
CatalogIconImageUrl

Obtiene o establece la dirección URL de una imagen que representa un control GenericWebPart en un catálogo de controles.

ChildControl

Obtiene una referencia al control secundario incluido dentro de un control GenericWebPart en tiempo de ejecución.

ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.

(Heredado de Control)
ChromeState

Obtiene o establece si un control de elementos está en un estado minimizado o normal.

(Heredado de WebPart)
ChromeType

Obtiene o establece el tipo de borde que encuadra un control de elementos Web.

(Heredado de WebPart)
ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.

(Heredado de Control)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.

(Heredado de Control)
ConnectErrorMessage

Obtiene un mensaje de error que se muestra a los usuarios si se producen errores durante el proceso de conexión.

(Heredado de WebPart)
Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.

(Heredado de Control)
Controls

Obtiene un objeto ControlCollection que contiene los controles secundarios para un control de servidor especificado en la jerarquía de la interfaz de usuario.

(Heredado de Part)
ControlStyle

Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
ControlStyleCreated

Obtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
CssClass

Obtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente.

(Heredado de WebControl)
DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.

(Heredado de Control)
DefaultButton

Obtiene o establece el identificador del botón predeterminado incluido en el control Panel.

(Heredado de Panel)
Description

Obtiene o establece una frase breve que resume lo que hace un control, para que se utilice en la información sobre herramientas y en los catálogos de controles de servidor.

DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.

(Heredado de Control)
Direction

Obtiene o establece la dirección horizontal en la que fluye el contenido dentro del control.

(Heredado de WebPart)
DisplayTitle

Obtiene una cadena que contiene el texto del título completo que se muestra realmente en la barra de título de la instancia de un control WebPart.

(Heredado de WebPart)
Enabled

Obtiene o establece un valor que indica si el control de servidor web está habilitado.

(Heredado de WebControl)
EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.

(Heredado de WebControl)
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.

(Heredado de Control)
Events

Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura.

(Heredado de Control)
ExportMode

Obtiene o establece si se pueden exportar todas, algunas o ninguna de las propiedades de un control WebPart.

(Heredado de WebPart)
Font

Obtiene las propiedades de fuente asociadas al control de servidor web.

(Heredado de WebControl)
ForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web.

(Heredado de WebControl)
GroupingText

Obtiene o establece el título del grupo de controles contenido en el control de panel.

(Heredado de Panel)
HasAttributes

Obtiene un valor que indica si el control tiene establecido algún atributo.

(Heredado de WebControl)
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.

(Heredado de Control)
HasSharedData

Obtiene un valor que indica si un control WebPart tiene datos de personalización compartidos asociados a él.

(Heredado de WebPart)
HasUserData

Obtiene un valor que indica si un control WebPart tiene datos de personalización de usuario asociados a él.

(Heredado de WebPart)
Height

Obtiene o establece el alto (en píxeles) de un control.

HelpMode

Obtiene o establece el tipo de interfaz de usuario usada para mostrar el contenido de la Ayuda de un control WebPart.

(Heredado de WebPart)
HelpUrl

Obtiene o establece la dirección URL en un archivo de Ayuda de un control WebPart.

(Heredado de WebPart)
Hidden

Obtiene o establece un valor que indica si un control WebPart se muestra en una página Web.

(Heredado de WebPart)
HorizontalAlign

Obtiene o establece la alineación horizontal del contenido del panel.

(Heredado de Panel)
ID

Obtiene o establece el id. de un control. Este valor no se puede heredar.

IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.

(Heredado de Control)
ImportErrorMessage

Obtiene o establece un mensaje de error que se utiliza si se producen errores cuando se importa un control WebPart.

(Heredado de WebPart)
IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.

(Heredado de Control)
IsClosed

Obtiene un valor que indica si un control WebPart está cerrado en un momento dado en una página de elementos Web.

(Heredado de WebPart)
IsEnabled

Obtiene un valor que indica si está habilitado el control.

(Heredado de WebControl)
IsShared

Obtiene un valor que indica si un control WebPart está compartido, lo que significa que es visible para todos los usuarios de una página de elementos Web.

(Heredado de WebPart)
IsStandalone

Obtiene un valor que indica si un control WebPart es independiente, lo que significa que no está incluido dentro de una zona WebPartZoneBase.

(Heredado de WebPart)
IsStatic

Obtiene un valor que indica si un control WebPart es estático, lo que significa que el control se declaró en el marcado de una página de elementos Web y no se agregó a la página mediante programación.

(Heredado de WebPart)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.

(Heredado de Control)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este 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.

(Heredado de Control)
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.

(Heredado de Control)
Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.

(Heredado de Control)
Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.

(Heredado de Control)
RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.

(Heredado de Control)
ScrollBars

Obtiene o establece la visibilidad y la posición de las barras de desplazamiento de un control Panel.

(Heredado de Panel)
Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.

(Heredado de Control)
SkinID

Obtiene o establece la máscara que se aplica al control.

(Heredado de WebControl)
Style

Obtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web.

(Heredado de WebControl)
Subtitle

Obtiene una cadena que se concatena con el valor de la propiedad Title para formar un título completo para un control.

SupportsDisabledAttribute

Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.

(Heredado de Panel)
TabIndex

Obtiene o establece el índice de tabulación del control de servidor web.

(Heredado de WebControl)
TagKey

Obtiene el valor HtmlTextWriterTag correspondiente al control de servidor web. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
TagName

Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.

(Heredado de Control)
Title

Obtiene o establece el título de un control GenericWebPart.

TitleIconImageUrl

Obtiene o establece la dirección URL de una imagen que se utiliza para representar un control GenericWebPart en la propia barra de título del control.

TitleUrl

Obtiene o establece una dirección URL de información complementaria sobre un control GenericWebPart.

ToolTip

Obtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web.

(Heredado de WebControl)
UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.

(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.

(Heredado de Control)
Verbs

Obtiene una colección de verbos personalizados asociados a un control GenericWebPart.

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.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.

(Heredado de Control)
Visible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.

(Heredado de Control)
WebBrowsableObject

Obtiene una referencia al control secundario para permitir que los controles EditorPart personalizados editen dicho control.

WebPartManager

Obtiene una referencia al control WebPartManager asociado a una instancia del control WebPart.

(Heredado de WebPart)
Width

Obtiene o establece el ancho (en píxeles) del control.

Wrap

Obtiene o establece un valor que indica si el contenido se ajusta dentro del panel.

(Heredado de Panel)
Zone

Obtiene la zona WebPartZoneBase que contiene un control WebPart en ese momento.

(Heredado de WebPart)
ZoneIndex

Obtiene la posición de índice de un control WebPart dentro de su zona.

(Heredado de WebPart)

Métodos

AddAttributesToRender(HtmlTextWriter)

Agrega información sobre la imagen de fondo, alineación, ajuste y dirección a la lista de atributos que se van a presentar.

(Heredado de Panel)
AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.

(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.

(Heredado de Control)
ApplyStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles.

(Heredado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.

(Heredado de Control)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de 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.

(Heredado de Control)
ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.

(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.

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.

(Heredado de Control)
CopyBaseAttributes(WebControl)

Copia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
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.

CreateControlCollection()

Reemplaza el método base para crear una colección de sólo lectura constituida por el control secundario incluido dentro de un control GenericWebPart.

CreateControlStyle()

Crea un objeto de estilo que usa el control Panel de forma interna para implementar todas las propiedades relacionadas con el estilo.

(Heredado de Panel)
CreateEditorParts()

Devuelve una colección de controles EditorPart personalizados que pueden utilizarse para editar el control secundario de un control GenericWebPart cuando se encuentra en modo de edición.

DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

(Heredado de Part)
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.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.

(Heredado de Control)
Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea.

(Heredado de Control)
EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.

(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. Esta versión del método FindControl no se debe reemplazar.

(Heredado de Control)
Focus()

Establece el foco de entrada en un control.

(Heredado de Control)
GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.

(Heredado de Control)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(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.

(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.

(Heredado de Control)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.

(Heredado de Control)
HasControls()

Determina si el control de servidor contiene controles secundarios.

(Heredado de Control)
HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.

(Heredado de Control)
IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.

(Heredado de Control)
LoadControlState(Object)

Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().

(Heredado de Control)
LoadViewState(Object)

Restaura la información del estado de la vista a partir de una solicitud anterior que se guardó con el método SaveViewState().

(Heredado de WebControl)
MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.

(Heredado de Control)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MergeStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
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.

(Heredado de Control)
OnClosing(EventArgs)

Permite a las clases derivadas proporcionar una administración personalizada cuando se cierra un control WebPart en una página de elementos Web.

(Heredado de WebPart)
OnConnectModeChanged(EventArgs)

Permite a las clases derivadas proporcionar una administración personalizada cuando un control WebPart va a comenzar o finalizar el proceso de conexión con otros controles.

(Heredado de WebPart)
OnDataBinding(EventArgs)

Genera el evento DataBinding.

(Heredado de Control)
OnDeleting(EventArgs)

Permite a las clases derivadas proporcionar una administración personalizada cuando un control WebPart se quita permanentemente de una página de elementos Web.

(Heredado de WebPart)
OnEditModeChanged(EventArgs)

Permite a las clases derivadas proporcionar una administración personalizada cuando un control WebPart va a entrar o salir del modo de edición.

(Heredado de WebPart)
OnInit(EventArgs)

Genera el evento Init.

(Heredado de Control)
OnLoad(EventArgs)

Genera el evento Load.

(Heredado de Control)
OnPreRender(EventArgs)

Genera el evento PreRender.

(Heredado de Control)
OnUnload(EventArgs)

Genera el evento Unload.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.

(Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.

(Heredado de Control)
RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.

(Heredado de Control)
Render(HtmlTextWriter)

Delega la representación del contenido del control en el control secundario.

RenderBeginTag(HtmlTextWriter)

Presenta la etiqueta HTML de apertura del control Panel en el sistema de escritura especificado.

(Heredado de Panel)
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.

(Heredado de Control)
RenderContents(HtmlTextWriter)

Representa el contenido del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
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.

(Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.

(Heredado de Control)
RenderEndTag(HtmlTextWriter)

Presenta la etiqueta HTML de cierre del control Panel en el escritor especificado.

(Heredado de Panel)
ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.

(Heredado de Control)
SaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.

(Heredado de Control)
SaveViewState()

Guarda cualquier estado modificado después de invocar el método TrackViewState().

(Heredado de WebControl)
SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.

(Heredado de Control)
SetPersonalizationDirty()

Establece un marcador que muestra que han cambiado los datos de personalización de la instancia actual del control WebPart.

(Heredado de WebPart)
SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.

(Heredado de 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.

(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.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Hace que el control realice un seguimiento de los cambios en su estado de vista para que puedan almacenarse en la propiedad ViewState del objeto.

(Heredado de WebPart)

Eventos

DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.

(Heredado de Control)
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.

(Heredado de Control)
Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.

(Heredado de Control)
Load

Se produce cuando el control de servidor se carga en el objeto Page.

(Heredado de Control)
PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.

(Heredado de Control)
Unload

Se produce cuando el control de servidor se descarga de la memoria.

(Heredado de Control)

Implementaciones de interfaz explícitas

IAttributeAccessor.GetAttribute(String)

Obtiene un atributo del control Web con el nombre especificado.

(Heredado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Establece un atributo del control Web con el nombre y el valor especificados.

(Heredado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Le permite al programador de un diseñador para un control de elementos compuesto volver a crear los controles secundarios del control en la superficie de diseño.

(Heredado de Part)
IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obtener una descripción de este miembro, vea GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para obtener una descripción de este miembro, vea UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.

(Heredado de Control)
IExpressionsAccessor.Expressions

Para obtener una descripción de este miembro, vea Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.

(Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).

(Heredado de Control)

Métodos de extensión

FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.

FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.

GetDefaultValues(INamingContainer)

Obtiene la colección de los valores predeterminados para el control de datos especificado.

GetMetaTable(INamingContainer)

Obtiene los metadatos de la tabla para el control de datos especificado.

SetMetaTable(INamingContainer, MetaTable)

Establece los metadatos de la tabla para el control de datos especificado.

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

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina si están disponibles los metadatos de la tabla.

EnableDynamicData(INamingContainer, Type)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.

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

Habilita el comportamiento de datos dinámicos para el control de datos especificado.

EnableDynamicData(INamingContainer, Type, Object)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.

Se aplica a

Consulte también