Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DataBoundControl

 

Publicado: octubre de 2016

Actúa como clase base para todos los controles enlazados a datos de la versión 2.0 de ASP.NET que muestran sus datos en formato de lista o tabular.

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.DataVisualization.Charting.Chart
          System.Web.UI.WebControls.AdRotator
          System.Web.UI.WebControls.CompositeDataBoundControl
          System.Web.UI.WebControls.ListControl
          System.Web.UI.WebControls.ListView

public abstract class DataBoundControl : BaseDataBoundControl

NombreDescripción
System_CAPS_protmethodDataBoundControl()

Inicializa la DataBoundControl clase para su uso por una instancia de la clase heredada. A este constructor solo lo puede llamar una clase heredada.

NombreDescripción
System_CAPS_pubpropertyAccessKey

Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor Web.(Heredado de WebControl).

System_CAPS_protpropertyAdapter

Obtiene el adaptador específico del explorador para el control.(Heredado de Control).

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativa a la aplicación de la Page o UserControl objeto que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyAttributes

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

System_CAPS_pubpropertyBackColor

Obtiene o establece el color de fondo del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyBindingContainer

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el control que contiene el enlace de datos del control.(Heredado de Control).

System_CAPS_pubpropertyBorderColor

Obtiene o establece el color del borde del control Web.(Heredado de WebControl).

System_CAPS_pubpropertyBorderStyle

Obtiene o establece el estilo de borde del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyBorderWidth

Obtiene o establece el ancho del borde del control de servidor Web.(Heredado de WebControl).

System_CAPS_protpropertyChildControlsCreated

Obtiene un valor que indica si se crearon los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubpropertyClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.(Heredado de Control).

System_CAPS_pubpropertyClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad.(Heredado de Control).

System_CAPS_protpropertyClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en el ClientID propiedad.(Heredado de Control).

System_CAPS_protpropertyContext

Obtiene el HttpContext objeto asociado con el control de servidor para la solicitud Web actual.(Heredado de Control).

System_CAPS_pubpropertyControls

Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.(Heredado de Control).

System_CAPS_pubpropertyControlStyle

Obtiene el estilo del control de servidor Web. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyControlStyleCreated

Obtiene un valor que indica si un Style se ha creado el objeto para el ControlStyle propiedad. Esta propiedad se utiliza principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyCssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) representada por el control de servidor Web en el cliente.(Heredado de WebControl).

System_CAPS_pubpropertyDataItemContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataItemContainer.(Heredado de Control).

System_CAPS_pubpropertyDataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataKeysControl.(Heredado de Control).

System_CAPS_pubpropertyDataMember

Obtiene o establece el nombre de la lista de datos que se enlaza el control enlazado a datos, en casos donde el origen de datos contiene más de una lista distintiva de elementos de datos.

System_CAPS_pubpropertyDataSource

Obtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos.(Heredado de BaseDataBoundControl).

System_CAPS_pubpropertyDataSourceID

Obtiene o establece el identificador del control desde el que el control enlazado a datos recupera su lista de elementos de datos.(Invalida BaseDataBoundControl.DataSourceID).

System_CAPS_pubpropertyDataSourceObject

Obtiene un objeto que implementa el IDataSource interfaz, que proporciona acceso al contenido de los datos del objeto.

System_CAPS_protpropertyDesignMode

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

System_CAPS_pubpropertyEnabled

Obtiene o establece un valor que indica si está habilitado el control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyEnableTheming

Obtiene o establece un valor que indica si se aplican temas a este control.(Heredado de WebControl).

System_CAPS_pubpropertyEnableViewState

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

System_CAPS_protpropertyEvents

Obtiene una lista de delegados de controladores de eventos para el control. Esta propiedad es de sólo lectura.(Heredado de Control).

System_CAPS_pubpropertyFont

Obtiene las propiedades de fuente asociadas con el control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyForeColor

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

System_CAPS_pubpropertyHasAttributes

Obtiene un valor que indica si el control tiene un atributo del conjunto.(Heredado de WebControl).

System_CAPS_protpropertyHasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardado.(Heredado de Control).

System_CAPS_pubpropertyHeight

Obtiene o establece el alto del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyID

Obtiene o establece el identificador de programación asignado al control de servidor.(Heredado de Control).

System_CAPS_protpropertyIdSeparator

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el carácter utilizado para separar los identificadores de control.(Heredado de Control).

System_CAPS_protpropertyInitialized

Obtiene un valor que indica si se ha inicializado el control enlazado a datos.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertyIsBoundUsingDataSourceID

Obtiene un valor que indica si el DataSourceID se establece la propiedad.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertyIsChildControlStateCleared

Obtiene un valor que indica si los controles incluidos en este control tienen estado de control.(Heredado de Control).

System_CAPS_protpropertyIsDataBindingAutomatic

Obtiene un valor que indica si el enlace de datos es automático.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertyIsEnabled

Obtiene un valor que indica si el control está habilitado.(Heredado de WebControl).

System_CAPS_protpropertyIsTrackingViewState

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

System_CAPS_protpropertyIsUsingModelBinders

Obtiene un valor que indica si el enlace de modelos está en uso.(Invalida BaseDataBoundControl.IsUsingModelBinders).

System_CAPS_protpropertyIsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.(Heredado de Control).

System_CAPS_pubpropertyItemType

Obtiene o establece el nombre del tipo de elemento de datos para el enlace de datos fuertemente tipados.

System_CAPS_protpropertyLoadViewStateByID

Obtiene un valor que indica si el control participa en la carga su estado de vista por ID en lugar de índice.(Heredado de Control).

System_CAPS_pubpropertyNamingContainer

Obtiene una referencia al control de servidor de nombres del contenedor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor con el mismo Control.ID valor de propiedad.(Heredado de Control).

System_CAPS_pubpropertyPage

Obtiene una referencia a la Page instancia que contiene el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyParent

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

System_CAPS_pubpropertyRenderingCompatibility

Obtiene un valor que especifica será compatible con la versión de ASP.NET que se representa en HTML.(Heredado de Control).

System_CAPS_protpropertyRequiresDataBinding

Obtiene o establece un valor que indica si el DataBind debe llamar al método.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertySelectArguments

Obtiene un DataSourceSelectArguments que el control enlazado a datos se utiliza al recuperar datos de un control de origen de datos de objeto.

System_CAPS_pubpropertySelectMethod

El nombre del método para llamar a fin de leer los datos.

System_CAPS_pubpropertySite

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertySkinID

Obtiene o establece la máscara que se aplica al control.(Heredado de WebControl).

System_CAPS_pubpropertyStyle

Obtiene una colección de atributos de texto que se representan como un atributo de estilo en la etiqueta externa del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertySupportsDisabledAttribute

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 BaseDataBoundControl).

System_CAPS_pubpropertyTabIndex

Obtiene o establece el índice de tabulación del control de servidor Web.(Heredado de WebControl).

System_CAPS_protpropertyTagKey

Obtiene el HtmlTextWriterTag valor que corresponde a este control de servidor Web. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protpropertyTagName

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

System_CAPS_pubpropertyTemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyTemplateSourceDirectory

Obtiene el directorio virtual de la Page o UserControl que contiene el control de servidor actual.(Heredado de Control).

System_CAPS_pubpropertyToolTip

Obtiene o establece el texto mostrado cuando el puntero del mouse se sitúa sobre el control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyUniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el Explorador de valores potencialmente peligrosos.(Heredado de Control).

System_CAPS_protpropertyViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor a través de varias solicitudes de la misma página.(Heredado de Control).

System_CAPS_protpropertyViewStateIgnoresCase

Obtiene un valor que indica si la StateBag objeto distingue mayúsculas de minúsculas.(Heredado de Control).

System_CAPS_pubpropertyViewStateMode

Obtiene o establece el modo de estado de vista de este control.(Heredado de Control).

System_CAPS_pubpropertyVisible

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

System_CAPS_pubpropertyWidth

Obtiene o establece el ancho del control de servidor web.(Heredado de WebControl).

NombreDescripción
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos que se deben representar HTML especificado HtmlTextWriterTag. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodAddedControl(Control, Int32)

Se llama después de que se agrega un control secundario a la Controls colección de la Control objeto.(Heredado de Control).

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

System_CAPS_pubmethodApplyStyle(Style)

Copia los elementos no vacíos del estilo especificado en el control Web, sobrescribiendo los elementos de estilo existentes del control. Este método se utiliza principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Se aplica a las propiedades de estilo definidas en la hoja de estilo de página para el control.(Heredado de Control).

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Comienza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Recopila información sobre el control de servidor y la pasa a la Trace propiedad que se mostrará cuando el seguimiento está habilitado para la página.(Heredado de Control).

System_CAPS_protmethodClearCachedClientID()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece la caché ClientID valor a null.(Heredado de Control).

System_CAPS_protmethodClearChildControlState()

Elimina la información de estado de control para los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildState()

Elimina la información de estado de vista y el estado de control para los controles secundarios todos del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildViewState()

Elimina la información de estado de vista para todo el servidor controles secundarios del control.(Heredado de Control).

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece el ClientIDMode propiedad de la instancia actual del control y de todos los controles secundarios a Inherit.(Heredado de Control).

System_CAPS_protmethodConfirmInitState()

Establece el estado inicializado del control enlazado a datos.(Heredado de BaseDataBoundControl).

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

Copia las propiedades que no están encapsuladas por la Style objeto desde el control de servidor Web especificado al control de servidor Web que se llama a este método. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodCreateChildControls()

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

System_CAPS_protmethodCreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.(Heredado de Control).

System_CAPS_protmethodCreateControlStyle()

Crea el objeto de estilo que se usa internamente el WebControl propiedades relacionadas con la clase para implementar todos los estilos. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodCreateDataSourceSelectArguments()

Crea un valor predeterminado DataSourceSelectArguments objeto utilizado por el control enlazado a datos si no se especifica ningún argumento.

System_CAPS_pubmethodDataBind()

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

System_CAPS_protmethodDataBind(Boolean)

Enlaza un origen de datos para el control de servidor invocado y todos sus controles secundarios con una opción para generar el DataBinding eventos.(Heredado de Control).

System_CAPS_protmethodDataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubmethodDispose()

Habilita un control de servidor realizar la limpieza final antes de que se libere de la memoria.(Heredado de Control).

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Finaliza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodEnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.(Heredado de Control).

System_CAPS_protmethodEnsureDataBound()

Llamadas del DataBind método si el DataSourceID se establece la propiedad y el control enlazado a datos está marcado para que requiera el enlace.(Heredado de BaseDataBoundControl).

System_CAPS_protmethodEnsureID()

Crea un identificador para los controles que no tienen un identificador asignado.(Heredado de Control).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFindControl(String)

Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id parámetro.(Heredado de Control).

System_CAPS_protmethodFindControl(String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id y un entero especificado en el pathOffset parámetro, lo que ayuda en la búsqueda. No se debe reemplazar esta versión de la FindControl (método).(Heredado de Control).

System_CAPS_pubmethodFocus()

Establece el foco en un control de entrada.(Heredado de Control).

System_CAPS_protmethodGetData()

Recupera un DataSourceView que el control enlazado a datos se utiliza para realizar operaciones de datos de objeto.

System_CAPS_protmethodGetDataSource()

Recupera el IDataSource interfaz que está asociado el control enlazado a datos, si existe.

System_CAPS_protmethodGetDesignModeState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene los datos de tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetRouteUrl(Object)

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

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

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

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

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

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Devuelve la parte fija de la UniqueID propiedad del control especificado.(Heredado de Control).

System_CAPS_pubmethodHasControls()

Determina si el control de servidor contiene todos los controles secundarios.(Heredado de Control).

System_CAPS_protmethodHasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.(Heredado de Control).

System_CAPS_protmethodIsLiteralContent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Determina si el control de servidor alberga únicamente contenido literal.(Heredado de Control).

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

System_CAPS_protmethodLoadViewState(Object)

Restaura la información de estado de vista de una solicitud de página anterior guardada por el SaveViewState (método).(Invalida WebControl.LoadViewState(Object)).

System_CAPS_protmethodMapPathSecure(String)

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

System_CAPS_protmethodMarkAsDataBound()

Establece el estado del control en estado de vista como correctamente enlazado a datos.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodMergeStyle(Style)

Copia los elementos no vacíos del estilo especificado en el Web controlan pero no sobrescribirá ningún elemento de estilo existente del control. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

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

System_CAPS_protmethodOnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Genera el evento CreatingModelDataSource.

System_CAPS_protmethodOnDataBinding(EventArgs)

Genera el evento DataBinding.(Heredado de Control).

System_CAPS_protmethodOnDataBound(EventArgs)

Genera el evento DataBound.(Heredado de BaseDataBoundControl).

System_CAPS_protmethodOnDataPropertyChanged()

Vuelve a enlazar el control enlazado a datos a sus datos después de que uno de la base de datos de origen de cambios de propiedades de identificación.(Invalida BaseDataBoundControl.OnDataPropertyChanged()).

System_CAPS_protmethodOnDataSourceViewChanged(Object, EventArgs)

Genera el evento DataSourceViewChanged.

System_CAPS_protmethodOnInit(EventArgs)

Controla el Init eventos.(Heredado de BaseDataBoundControl).

System_CAPS_protmethodOnLoad(EventArgs)

Controla el Control.Load eventos.(Invalida Control.OnLoad(EventArgs)).

System_CAPS_protmethodOnPagePreLoad(Object, EventArgs)

Establece el estado inicializado del control enlazado a datos antes de cargar el control.(Invalida BaseDataBoundControl.OnPagePreLoad(Object, EventArgs)).

System_CAPS_protmethodOnPreRender(EventArgs)

Controla el PreRender eventos.(Heredado de BaseDataBoundControl).

System_CAPS_protmethodOnUnload(EventArgs)

Genera el evento Unload.(Heredado de Control).

System_CAPS_protmethodOpenFile(String)

Obtiene un Stream utilizado para leer un archivo.(Heredado de Control).

System_CAPS_protmethodPerformDataBinding(IEnumerable)

Cuando se invalida en una clase derivada, enlaza los datos del origen de datos al control.

System_CAPS_protmethodPerformSelect()

Recupera los datos del origen de datos asociado.(Invalida BaseDataBoundControl.PerformSelect()).

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al elemento primario del control.(Heredado de Control).

System_CAPS_protmethodRemovedControl(Control)

Se llama después de que se quita un control secundario de la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodRender(HtmlTextWriter)

Representa el control en el sistema de escritura HTML especificado.(Heredado de WebControl).

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un HtmlTextWriter objeto, que escribe el contenido que se va a representar en el cliente.(Heredado de Control).

System_CAPS_protmethodRenderContents(HtmlTextWriter)

Representa el contenido del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Genera el contenido del control de servidor a un HtmlTextWriter de objeto y almacena información de seguimiento sobre el control si está habilitado el seguimiento.(Heredado de Control).

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Genera el contenido del control de servidor a un HtmlTextWriter objeto usando una URL ControlAdapter objeto.(Heredado de Control).

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

Representa la etiqueta HTML de cierre del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.(Heredado de Control).

System_CAPS_pubmethodResolveClientUrl(String)

Obtiene una dirección URL que se puede usar el explorador.(Heredado de Control).

System_CAPS_pubmethodResolveUrl(String)

Convierte una dirección URL en una que se puede usar en el cliente solicitante.(Heredado de Control).

System_CAPS_protmethodSaveControlState()

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

System_CAPS_protmethodSaveViewState()

Guarda los cambios de estado de vista que se han producido desde la hora en que se devolvió la página al servidor.(Invalida WebControl.SaveViewState()).

System_CAPS_protmethodSetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando la clave de datos de seguimiento y el valor de datos de seguimiento de seguimiento.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando el objeto de seguimiento, la clave de datos de seguimiento y el valor de datos de seguimiento de traza.(Heredado de Control).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_protmethodTrackViewState()

Hace que los cambios de estado de vista en el control que se va a realizar un seguimiento para que puedan almacenarse en el control StateBag objeto.(Invalida WebControl.TrackViewState()).

System_CAPS_protmethodValidateDataSource(Object)

Comprueba que el objeto al que se enlaza un control enlazado a datos es compatible con.(Invalida BaseDataBoundControl.ValidateDataSource(Object)).

NombreDescripción
System_CAPS_pubeventCallingDataMethods

Se produce mientras se llama a los métodos de datos.

System_CAPS_pubeventCreatingModelDataSource

Se produce cuando el ModelDataSource se crea el objeto.

System_CAPS_pubeventDataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.(Heredado de Control).

System_CAPS_pubeventDataBound

Se produce después de que el control de servidor se enlaza a un origen de datos.(Heredado de BaseDataBoundControl).

System_CAPS_pubeventDisposed

Se produce cuando un control de servidor se libera de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página ASP.NET.(Heredado de Control).

System_CAPS_pubeventInit

Se produce cuando se inicializa el control de servidor, que es el primer paso del ciclo de vida.(Heredado de Control).

System_CAPS_pubeventLoad

Se produce cuando el control de servidor se carga en el Page objeto.(Heredado de Control).

System_CAPS_pubeventPreRender

Se produce después de la Control es cargado pero antes de la representación.(Heredado de Control).

System_CAPS_pubeventUnload

Se produce cuando el control de servidor se descarga de la memoria.(Heredado de Control).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene un atributo del control Web con el nombre especificado.(Heredado de WebControl).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

Establece un atributo del control Web en el nombre y valor especificados.(Heredado de WebControl).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea IParserAccessor.AddParsedSubObject.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para una descripción de este miembro, vea IControlDesignerAccessor.UserData.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.DataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para una descripción de este miembro, vea IExpressionsAccessor.Expressions.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea IExpressionsAccessor.HasExpressions.(Heredado de Control).

NombreDescripción
System_CAPS_pubmethodEnablePersistedSelection()

Obsoleto. Habilita la selección para que persista en controles de datos que admiten selección y paginación.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindDataSourceControl()

Devuelve el origen de datos que está asociado con el control de datos para el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindFieldTemplate(String)

Devuelve que el contenedor de nomenclatura de la plantilla de campo para la columna especificada en el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindMetaTable()

Devuelve el objeto de metatabla para el control de datos que contiene.(Definido por DynamicDataExtensions).

The T:System.Web.UI.WebControls.DataBoundControl class is the base class used for ASP.NET controls that retrieve tabular or list-style data from an ASP.NET data source control and bind user-interface (UI) elements of the control to that data for display. Composite data-bound controls such as T:System.Web.UI.WebControls.GridView, T:System.Web.UI.WebControls.DetailsView, and T:System.Web.UI.WebControls.FormView; list-style data-bound controls such as T:System.Web.UI.WebControls.BulletedList and T:System.Web.UI.WebControls.CheckBoxList; and other controls such as T:System.Web.UI.WebControls.AdRotator derive from T:System.Web.UI.WebControls.DataBoundControl.

Page developers do not use the T:System.Web.UI.WebControls.DataBoundControl class directly; instead, they use controls that derive from this class.

Control developers extend this class to create data-bound controls that work with classes that implement the T:System.Web.UI.IDataSource interface and classes that derive from the T:System.Web.UI.DataSourceControl and T:System.Web.UI.DataSourceView classes. When deriving a class from the T:System.Web.UI.WebControls.DataBoundControl class, override the M:System.Web.UI.WebControls.DataBoundControl.PerformDataBinding(System.Collections.IEnumerable) method to bind the UI elements of your control to data retrieved by the M:System.Web.UI.WebControls.DataBoundControl.GetData method. In most cases, the M:System.Web.UI.WebControls.DataBoundControl.PerformDataBinding(System.Collections.IEnumerable) method is the only method you will override in your derived class.

For ASP.NET 2.0 data-bound controls, the M:System.Web.UI.WebControls.DataBoundControl.PerformSelect method is the equivalent of the DataBind method, and is called to bind data at run time. The M:System.Web.UI.WebControls.DataBoundControl.PerformSelect method calls the M:System.Web.UI.WebControls.DataBoundControl.GetData and M:System.Web.UI.WebControls.DataBoundControl.PerformDataBinding(System.Collections.IEnumerable) methods.

The following code example demonstrates how to derive a class from the T:System.Web.UI.WebControls.DataBoundControl class to create a custom data-bound control. The TextBoxSet control creates a T:System.Web.UI.WebControls.TextBox control for each data item retrieved from its associated data source control, and binds to the value of the data item at run time. The current implementation of the Render method renders the T:System.Web.UI.WebControls.TextBox controls as an unordered list.

using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.Controls.CS {

    [AspNetHostingPermission(SecurityAction.Demand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    public class TextBoxSet : DataBoundControl {

        private IList alBoxSet;
        public IList BoxSet {
            get {
                if (null == alBoxSet) {
                     alBoxSet = new ArrayList();
                }
                return alBoxSet;                
            }                    
        }
        public string DataTextField {
            get {
                object o = ViewState["DataTextField"];
                return((o == null) ? string.Empty : (string)o);
            }
            set {
                ViewState["DataTextField"] = value;
                if (Initialized) {
                    OnDataPropertyChanged();
                }
            }
        }
        protected override void PerformSelect() {            

           // Call OnDataBinding here if bound to a data source using the
           // DataSource property (instead of a DataSourceID), because the
           // databinding statement is evaluated before the call to GetData.       
            if (! IsBoundUsingDataSourceID) {
                OnDataBinding(EventArgs.Empty);
            }            

            // The GetData method retrieves the DataSourceView object from  
            // the IDataSource associated with the data-bound control.            
            GetData().Select(CreateDataSourceSelectArguments(), 
                OnDataSourceViewSelectCallback);

            // The PerformDataBinding method has completed.
            RequiresDataBinding = false;
            MarkAsDataBound();

            // Raise the DataBound event.
            OnDataBound(EventArgs.Empty);
        }
        private void OnDataSourceViewSelectCallback(IEnumerable retrievedData) {

           // Call OnDataBinding only if it has not already been 
           // called in the PerformSelect method.
            if (IsBoundUsingDataSourceID) {
                OnDataBinding(EventArgs.Empty);
            }
            // The PerformDataBinding method binds the data in the  
            // retrievedData collection to elements of the data-bound control.
            PerformDataBinding(retrievedData);                                    
        }
        protected override void PerformDataBinding(IEnumerable retrievedData) {
            base.PerformDataBinding(retrievedData);

            // If the data is retrieved from an IDataSource as an 
            // IEnumerable collection, attempt to bind its values to a 
            // set of TextBox controls.
            if (retrievedData != null) {

                foreach (object dataItem in retrievedData) {

                    TextBox box = new TextBox();

                    // The dataItem is not just a string, but potentially
                    // a System.Data.DataRowView or some other container. 
                    // If DataTextField is set, use it to determine which 
                    // field to render. Otherwise, use the first field.                    
                    if (DataTextField.Length > 0) {
                        box.Text = DataBinder.GetPropertyValue(dataItem, 
                            DataTextField, null);
                    }
                    else {
                        PropertyDescriptorCollection props = 
                            TypeDescriptor.GetProperties(dataItem);

                        // Set the "default" value of the TextBox.
                        box.Text = String.Empty;

                        // Set the true data-bound value of the TextBox,
                        // if possible.
                        if (props.Count >= 1) {                        
                            if (null != props[0].GetValue(dataItem)) {
                                box.Text = props[0].GetValue(dataItem).ToString();
                            }
                        }
                    }                                        

                    BoxSet.Add(box);
                }
            }
        }
        protected override void Render(HtmlTextWriter writer) {

            // Render nothing if the control is empty.            
            if (BoxSet.Count <= 0) {
                return;
            }

            // Make sure the control is declared in a form tag 
            // with runat=server.
            if (Page != null) {
                Page.VerifyRenderingInServerForm(this);
            }

            // For this example, render the BoxSet as 
            // an unordered list of TextBox controls.            
            writer.RenderBeginTag(HtmlTextWriterTag.Ul);

            foreach (object item in BoxSet) {

                TextBox box = (TextBox) item;

                // Write each element as 
                // <li><input type="text" value="string"><input/></li>

                writer.WriteBeginTag("li");
                writer.Write(">");
                writer.WriteBeginTag("input");
                writer.WriteAttribute("type", "text");
                writer.WriteAttribute("value", box.Text);
                writer.Write(">");
                writer.WriteEndTag("input");
                writer.WriteEndTag("li");
            }            

            writer.RenderEndTag();                       
        }
    }
}

The following code example demonstrates how to use the TextBoxSet control, defined in the previous example, and bind it to an T:System.Web.UI.WebControls.AccessDataSource control.

<%@Page language="c#" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.Controls.CS" 
    Assembly="Samples.AspNet.Controls.CS" %>

<!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>
    <title>TextBoxSet Data-Bound Control  - C# Example</title>
  </head>

  <body>
    <form id="Form1" method="post" runat="server">

        <aspSample:textboxset
          id="TextBoxSet1"
          runat="server"
          datasourceid="AccessDataSource1" />

        <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datafile="Northwind.mdb"
          selectcommand="SELECT lastname FROM Employees" />

    </form>
  </body>
</html>

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: