Part Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Actúa como clase base para todos los controles de elementos web, que representan una interfaz de usuario modular en una página de Formularios Web Forms.
public ref class Part abstract : System::Web::UI::WebControls::Panel, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessor
public abstract class Part : System.Web.UI.WebControls.Panel, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessor
type Part = class
inherit Panel
interface INamingContainer
interface ICompositeControlDesignerAccessor
Public MustInherit Class Part
Inherits Panel
Implements ICompositeControlDesignerAccessor, INamingContainer
- Herencia
- Derivado
- Implementaciones
Ejemplos
En los ejemplos de código siguientes se muestra el uso declarativo de varias propiedades de la Part clase mediante dos instancias de un control personalizado WebPart al que se hace referencia en una página web de ASP.NET. Para que se ejecute el ejemplo de código, debe compilar este código fuente. Puede compilarlo explícitamente y colocar el ensamblado resultante en la carpeta Bin del sitio web o en la caché global de ensamblados. 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. Para ver un tutorial que muestre ambos métodos de compilación, vea Tutorial: Desarrollo y uso de un control de servidor web personalizado.
La primera parte del ejemplo contiene el código del control personalizado, denominado TextDisplayWebPart. Dado que el control deriva de WebPart, también hereda las propiedades comunes que proporciona la Part clase e ilustra el uso de esas propiedades en este ejemplo de código.
using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level=AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level=AspNetHostingPermissionLevel.Minimal)]
public class TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
const string _subTitle = "Contoso, Ltd";
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[
Personalizable(PersonalizationScope.User, true),
WebBrowsable()
]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor =
System.Drawing.Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
ChildControlsCreated = true;
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
// Clear the input textbox.
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.Security.Permissions
Imports System.Web
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 Class TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Public Sub New()
Me.AllowClose = False
End Sub
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.Text = Me.ContentText
DisplayContent.BackColor = _
System.Drawing.Color.LightBlue
Me.Controls.Add(DisplayContent)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
ChildControlsCreated = True
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
' Clear the input textbox.
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
La segunda parte del ejemplo muestra cómo hacer referencia a los controles de elementos personalizados en una página web de ASP.NET. Observe que las distintas Part propiedades se asignan mediante declaración a las instancias de control personalizadas. Compare el código declarativo que hace referencia a las dos instancias de la página y, a continuación, cargue la página en un explorador. Observe cómo afectan las distintas propiedades a la apariencia de los controles. Por ejemplo, después de cargar la página en un explorador, la segunda instancia del TextDisplayWebPart control aparece minimizada, porque su ChromeState valor de propiedad está establecido Minimizeden .
<%@ page language="C#" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS" %>
<!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>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB" %>
<!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>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Comentarios
La Part clase define las propiedades comunes a todos los controles de elementos y les permite tener una apariencia modular y coherente en una página web. Estas propiedades comunes incluyen un título, una descripción y características del cromo o marco que rodea un control de pieza.
La Title propiedad especifica un título para el control de pieza. La Description propiedad se usa para resumir el propósito del control de pieza y aparece como información sobre herramientas en la barra de título del control. La ChromeType propiedad determina qué tipo de borde se representa alrededor de un control de pieza, mientras que la ChromeState propiedad indica si un control de pieza se representa normalmente o se minimiza. El borde de un control de pieza se ve afectado por las propiedades de la zona que la contiene; Por ejemplo, la PartChromeType propiedad afecta a los marcos de todos los controles de elementos contenidos en una zona.
Un tipo de control de pieza es el WebPart control , que representa el contenido dentro de una zona correspondiente. Otro tipo es el EditorPart control , que proporciona controles de interfaz de usuario (UI) usados para modificar (personalizar) controles individuales WebPart . Un tercer tipo de control de elemento es el CatalogPart control , que proporciona una lista de WebPart controles que los usuarios pueden agregar o quitar de una página web.
Los controles de elementos se incluyen en zonas, todas las cuales derivan de la clase abstracta WebZone . Una zona es responsable de organizar los controles de pieza que contiene. Cada zona también representa los elementos de la interfaz de usuario para sí mismos, incluidos un encabezado, un pie de página, una barra de título y elementos de interfaz de usuario alrededor de cada control de pieza independiente, como bordes.
Nota:
Aunque los controles de elementos normalmente residen en zonas, es posible colocar un control de elemento fuera de una zona, si se hace referencia al control mediante declaración en el marcado de una página web. Si un control de elemento se declara fuera de una zona de una página web, el control sigue funcionando, pero pierde la mayor parte de su funcionalidad de elementos web. Por ejemplo, el control no se puede editar y no se puede arrastrar a una zona en tiempo de ejecución. También es útil recordar que no se puede arrastrar ningún control de pieza desde una zona y colocarse en una página fuera de una zona en tiempo de ejecución.
En la tabla siguiente se muestran algunos ejemplos de tipos de elementos base y sus tipos de zona correspondientes.
| Tipo de control de elemento | Tipo de zona |
|---|---|
| WebPart | WebPartZone |
| EditorPart | EditorZone |
| CatalogPart | CatalogZone |
Los distintos tipos de controles de parte que derivan de la Part clase controlan las propiedades heredadas orientadas a la interfaz de usuario de forma diferente.
WebPart los controles invalidan varias de las propiedades heredadas de la interfaz de usuario y las marcan con el Personalizable atributo (para obtener más información, consulte la documentación de clase PersonalizableAttribute ), que permite guardar los valores de esas propiedades para futuras sesiones del explorador, una característica conocida como personalización. Por ejemplo, si habilita mediante programación a un usuario para actualizar el valor de la propiedad de Title un WebPart control en tiempo de ejecución, ese valor se personalizará (suponiendo que la personalización esté habilitada, que es el valor predeterminado). Varias propiedades de interfaz de usuario que WebPart los controles heredan de la Part clase y de la WebControl clase se controlan de la misma manera.
Por el contrario, otros controles de elementos, como EditorPart y CatalogPart, no permiten personalizar las propiedades de la interfaz de usuario heredadas. Por este motivo, los valores de propiedad asignados mediante programación no se guardan para futuras sesiones del explorador. Por ejemplo, si habilita mediante programación a un usuario para actualizar la propiedad de Title un PropertyGridEditorPart control en tiempo de ejecución, el valor actualizado se pierde una vez cerrado el control o finaliza la sesión del explorador.
Una manera fácil de guardar los valores en estas propiedades heredadas de la interfaz de usuario para EditorPart y CatalogPart los controles para futuras sesiones del explorador es declarar los valores de propiedad en formato de persistencia de página. Sin embargo, se trata de un enfoque estático y todavía no permite a los usuarios personalizar los valores de propiedad. Como alternativa, si desea habilitar las actualizaciones mediante programación en las propiedades de la interfaz de usuario heredadas para que los usuarios puedan personalizarlas en tiempo de ejecución, puede usar variables privadas y estáticas para guardar los valores de propiedad. Cada vez que se crea una nueva instancia de un EditorPart control o CatalogPart (por ejemplo, en el método que controla el evento del Init control), puede reasignar el valor de una variable estática a una propiedad correspondiente. Este enfoque proporciona a los usuarios la capacidad de personalizar la interfaz de usuario de edición y la interfaz de usuario del catálogo de una aplicación de elementos web.
Notas a los implementadores
Normalmente, no debe heredar directamente de la Part clase para desarrollar controles de elementos web personalizados. Para proporcionar una funcionalidad completa de elementos web, el conjunto de controles de elementos web requiere las clases derivadas de la Part clase, es decir WebPart, , EditorParty CatalogPart, por lo que debe derivar de ellos para desarrollar controles personalizados. Sin embargo, todavía es importante comprender el comportamiento de la clase base Part , ya que proporciona un conjunto común de propiedades usadas por todas las demás clases de elementos.
Propiedades
| Nombre | Description |
|---|---|
| AccessKey |
Obtiene o establece la clave de acceso que le 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) |
| AppRelativeTemplateSourceDirectory |
Obtiene o establece el directorio virtual relativo a la Page aplicación del objeto o UserControl que contiene este control. (Heredado de Control) |
| Attributes |
Obtiene la colección de atributos arbitrarios (solo para la representación) que no corresponden a las propiedades del control. (Heredado de WebControl) |
| 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 de borde del control de servidor web. (Heredado de WebControl) |
| BorderWidth |
Obtiene o establece el ancho de borde del control de servidor web. (Heredado de WebControl) |
| ChildControlsCreated |
Obtiene un valor que indica si se han creado los controles secundarios del control de servidor. (Heredado de Control) |
| ChromeState |
Obtiene o establece si un control de pieza está en un estado minimizado o normal. |
| ChromeType |
Obtiene o establece el tipo de borde que enmarca un control de elementos web. |
| ClientID |
Obtiene el identificador de control para el marcado HTML generado por ASP.NET. (Heredado de Control) |
| ClientIDMode |
Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad . (Heredado de Control) |
| ClientIDSeparator |
Obtiene un valor de carácter que representa el carácter separador utilizado en la ClientID propiedad . (Heredado de Control) |
| Context |
Obtiene el HttpContext objeto asociado al control de servidor para la solicitud web actual. (Heredado de Control) |
| Controls |
Obtiene un ControlCollection objeto que contiene los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario. |
| ControlStyle |
Obtiene el estilo del control de servidor web. Esta propiedad se usa principalmente por los desarrolladores de control. (Heredado de WebControl) |
| ControlStyleCreated |
Obtiene un valor que indica si se ha creado un Style objeto para la ControlStyle propiedad . Esta propiedad la usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| CssClass |
Obtiene o establece la clase Hoja de estilos en cascada (CSS) representada por el control de servidor web en el cliente. (Heredado de WebControl) |
| DataItemContainer |
Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer. (Heredado de Control) |
| DataKeysContainer |
Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl. (Heredado de Control) |
| DefaultButton |
Obtiene o establece el identificador del botón predeterminado contenido en el Panel control . (Heredado de Panel) |
| Description |
Obtiene o establece una frase breve que resume lo que hace el control de pieza, para su uso en información sobre herramientas y catálogos de controles de elementos. |
| DesignMode |
Obtiene un valor que indica si se usa un control en una superficie de diseño. (Heredado de Control) |
| Direction |
Obtiene o establece la dirección en la que se muestran los controles que incluyen texto en un Panel control. (Heredado de Panel) |
| 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 y el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control) |
| Events |
Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura. (Heredado de Control) |
| 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 que se encuentra en el control del panel. (Heredado de Panel) |
| HasAttributes |
Obtiene un valor que indica si el control tiene los atributos establecidos. (Heredado de WebControl) |
| HasChildViewState |
Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada. (Heredado de Control) |
| Height |
Obtiene o establece el alto del control de servidor web. (Heredado de WebControl) |
| HorizontalAlign |
Obtiene o establece la alineación horizontal del contenido dentro del panel. (Heredado de Panel) |
| ID |
Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control) |
| IdSeparator |
Obtiene el carácter usado para separar los identificadores de control. (Heredado de Control) |
| IsChildControlStateCleared |
Obtiene un valor que indica si los controles contenidos en este control tienen estado de control. (Heredado de Control) |
| IsEnabled |
Obtiene un valor que indica si el control está habilitado. (Heredado de WebControl) |
| IsTrackingViewState |
Obtiene un valor que indica si el control de servidor guarda los cambios 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 en ID lugar del í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 entre los controles de servidor con el mismo ID valor de propiedad. (Heredado de Control) |
| Page |
Obtiene una referencia a la Page instancia que contiene el control de servidor. (Heredado de Control) |
| Parent |
Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página. (Heredado de Control) |
| RenderingCompatibility |
Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML. (Heredado de Control) |
| ScrollBars |
Obtiene o establece la visibilidad y la posición de las barras de desplazamiento en un Panel control . (Heredado de Panel) |
| Site |
Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño. (Heredado de Control) |
| SkinID |
Obtiene o establece la máscara que se va a aplicar al control. (Heredado de WebControl) |
| Style |
Obtiene una colección de atributos de texto que se representarán como un atributo de estilo en la etiqueta externa del control de servidor web. (Heredado de WebControl) |
| SupportsDisabledAttribute |
Obtiene un valor que indica si el control debe establecer el |
| TabIndex |
Obtiene o establece el índice de tabulación del control de servidor web. (Heredado de WebControl) |
| TagKey |
Obtiene el HtmlTextWriterTag valor que corresponde a este control de servidor web. Esta propiedad se usa principalmente por los desarrolladores de control. (Heredado de WebControl) |
| TagName |
Obtiene el nombre de la etiqueta de control. Esta propiedad se usa principalmente por los desarrolladores de control. (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 de pieza. |
| ToolTip |
Obtiene o establece el texto que se muestra cuando el puntero del mouse mantiene el puntero 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 detectar valores potencialmente peligrosos. (Heredado de Control) |
| ViewState |
Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para la misma página. (Heredado de Control) |
| ViewStateIgnoresCase |
Obtiene un valor que indica si el StateBag objeto no distingue mayúsculas de minúsculas. (Heredado de Control) |
| ViewStateMode |
Obtiene o establece el modo de 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) |
| Width |
Obtiene o establece el ancho del control de servidor web. (Heredado de WebControl) |
| Wrap |
Obtiene o establece un valor que indica si el contenido se ajusta dentro del panel. (Heredado de Panel) |
Métodos
| Nombre | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Agrega información sobre la imagen de fondo, la alineación, el ajuste y la dirección a la lista de atributos que se van a representar. (Heredado de Panel) |
| AddedControl(Control, Int32) |
Se llama después de agregar un control secundario a la Controls colección del Control objeto . (Heredado de Control) |
| AddParsedSubObject(Object) |
Notifica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto del control de ControlCollection servidor. (Heredado de Control) |
| ApplyStyle(Style) |
Copia todos los elementos que no sean de marca del estilo especificado en el control Web, sobrescribir los elementos de estilo existentes del control. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica las propiedades de estilo definidas en la hoja de estilos de página al control . (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 entrega a la Trace propiedad que se va a mostrar cuando el seguimiento está habilitado para la página. (Heredado de Control) |
| ClearCachedClientID() |
Establece el valor |
| ClearChildControlState() |
Elimina la información de estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildState() |
Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildViewState() |
Elimina la información de estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control) |
| ClearEffectiveClientIDMode() |
Establece la ClientIDMode propiedad de la instancia de control actual y de cualquier control secundario en Inherit. (Heredado de Control) |
| CopyBaseAttributes(WebControl) |
Copia las propiedades no encapsuladas por el Style objeto desde el control de servidor web especificado al control de servidor web desde el que se llama a este método. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl) |
| CreateChildControls() |
Llamado por el marco de ASP.NET página para notificar a los controles de servidor que usan la implementación basada en composición para crear los controles secundarios que contengan como preparación para la publicación o representación. (Heredado de Control) |
| CreateControlCollection() |
Crea un nuevo ControlCollection objeto para contener los controles secundarios (literal y servidor) del control de servidor. (Heredado de Control) |
| CreateControlStyle() |
Crea un objeto de estilo que el control usa internamente Panel para implementar todas las propiedades relacionadas con el estilo. (Heredado de Panel) |
| DataBind() |
Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. |
| DataBind(Boolean) |
Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios con una opción para generar el DataBinding evento. (Heredado de Control) |
| DataBindChildren() |
Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control) |
| Dispose() |
Permite que un control de servidor realice la limpieza final antes de liberarse 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 es así, crea controles secundarios. (Heredado de Control) |
| EnsureID() |
Crea un identificador para los controles que no tienen asignado un identificador. (Heredado de Control) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| FindControl(String, Int32) |
Busca en el contenedor de nomenclatura actual un control de servidor con el especificado |
| FindControl(String) |
Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado |
| Focus() |
Establece el foco de entrada en un control. (Heredado de Control) |
| GetDesignModeState() |
Obtiene los datos en tiempo de diseño de un control. (Heredado de Control) |
| GetHashCode() |
Actúa como 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 prefijo de la UniqueID propiedad 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 los eventos están registrados para el control o para los controles secundarios. (Heredado de Control) |
| IsLiteralContent() |
Determina si el control de servidor contiene solo contenido literal. (Heredado de Control) |
| LoadControlState(Object) |
Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState() método . (Heredado de Control) |
| LoadViewState(Object) |
Restaura la información de estado de vista de una solicitud anterior que se guardó con el SaveViewState() método . (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 Objectactual. (Heredado de Object) |
| MergeStyle(Style) |
Copia todos los elementos que no sean de marca del estilo especificado en el control Web, pero no sobrescribirán ningún elemento de estilo existente del control. Este método se usa principalmente por 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 controles de servidor de interfaz de usuario de la página. (Heredado de Control) |
| OnDataBinding(EventArgs) |
Genera el evento DataBinding. (Heredado de Control) |
| 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 que se usa para leer un archivo. (Heredado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Asigna cualquier origen del evento y su información al elemento primario del control. (Heredado de Control) |
| RemovedControl(Control) |
Se llama después de quitar un control secundario de la Controls colección del Control objeto . (Heredado de Control) |
| Render(HtmlTextWriter) |
Representa el control en el escritor HTML especificado. (Heredado de WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Representa la etiqueta de apertura HTML del Panel control en el escritor especificado. (Heredado de Panel) |
| RenderChildren(HtmlTextWriter) |
Genera el contenido de los elementos secundarios de un control de servidor en un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente. (Heredado de Control) |
| RenderContents(HtmlTextWriter) |
Representa el contenido del control en el escritor especificado. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter mediante un objeto proporcionado ControlAdapter . (Heredado de Control) |
| RenderControl(HtmlTextWriter) |
Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter y almacena información de seguimiento sobre el control si el seguimiento está habilitado. (Heredado de Control) |
| RenderEndTag(HtmlTextWriter) |
Representa la etiqueta de cierre HTML del Panel control en el escritor especificado. (Heredado de Panel) |
| ResolveAdapter() |
Obtiene el adaptador de control responsable de representar el control especificado. (Heredado de Control) |
| ResolveClientUrl(String) |
Obtiene una dirección URL que el explorador puede usar. (Heredado de Control) |
| ResolveUrl(String) |
Convierte una dirección URL en una que se pueda usar en el cliente solicitante. (Heredado de Control) |
| SaveControlState() |
Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor. (Heredado de Control) |
| SaveViewState() |
Guarda cualquier estado que se modificó después de invocar el TrackViewState() método . (Heredado de WebControl) |
| SetDesignModeState(IDictionary) |
Establece los datos en tiempo de diseño de un control. (Heredado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario. (Heredado de Control) |
| SetTraceData(Object, Object, Object) |
Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control) |
| SetTraceData(Object, Object) |
Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento 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 se puedan almacenar en la propiedad del ViewState objeto. (Heredado de WebControl) |
Eventos
| Nombre | Description |
|---|---|
| DataBinding |
Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control) |
| Disposed |
Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET. (Heredado de Control) |
| Init |
Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida. (Heredado de Control) |
| Load |
Se produce cuando el control de servidor se carga en el Page objeto . (Heredado de Control) |
| PreRender |
Se produce después de cargar el Control objeto, pero antes de la 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
| Nombre | Description |
|---|---|
| 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 en el nombre y el valor especificados. (Heredado de WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Permite al desarrollador de un diseñador de un control de pieza compuesta volver a crear los controles secundarios del control en la superficie de diseño. |
| 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
| Nombre | Description |
|---|---|
| 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. |
| EnableDynamicData(INamingContainer, Type) |
Habilita el comportamiento de datos dinámicos para el control de datos especificado. |
| FindDataSourceControl(Control) |
Devuelve el origen de datos asociado al control de datos para el control especificado. |
| FindFieldTemplate(Control, String) |
Devuelve la plantilla de campo de la columna especificada en el contenedor de nomenclatura del control especificado. |
| FindMetaTable(Control) |
Devuelve el objeto de metatable 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, IDictionary<String,Object>) |
Establece los metadatos de la tabla y la asignación de valores predeterminados para el control de datos especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Establece los metadatos de la tabla y la asignación de valores predeterminados para el control de datos especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Establece los metadatos de la tabla para el control de datos especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina si los metadatos de la tabla están disponibles. |