Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

DataBoundControl (Clase)

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

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

public abstract class DataBoundControl : BaseDataBoundControl
<asp:DataBoundControl />

El tipo DataBoundControl expone los siguientes miembros.

  NombreDescripción
Método protegidoDataBoundControlInicializa la clase DataBoundControl para su uso por parte de una instancia de la clase heredada. A este constructor sólo lo puede llamar una clase heredada.
Arriba

  NombreDescripción
Propiedad públicaAccessKeyObtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Se hereda de WebControl).
Propiedad protegidaAdapterObtiene el adaptador específico del explorador para el control. (Se hereda de Control).
Propiedad públicaAppRelativeTemplateSourceDirectoryObtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Se hereda de Control).
Propiedad públicaAttributesObtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control. (Se hereda de WebControl).
Propiedad públicaBackColorObtiene o establece el color de fondo del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBindingContainerInfraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
Propiedad públicaBorderColorObtiene o establece el color de borde del control Web. (Se hereda de WebControl).
Propiedad públicaBorderStyleObtiene o establece el estilo del borde del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBorderWidthObtiene o establece el ancho del borde del control de servidor web. (Se hereda de WebControl).
Propiedad protegidaChildControlsCreatedObtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control).
Propiedad públicaClientIDObtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control).
Propiedad públicaClientIDModeObtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control).
Propiedad protegidaClientIDSeparatorObtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
Propiedad protegidaContextObtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control).
Propiedad públicaControlsObtiene un objeto ControlCollection que representa los controles secundarios para un control de servidor especificado en la jerarquía de la interfaz de usuario. (Se hereda de Control).
Propiedad públicaControlStyleObtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaControlStyleCreatedObtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaCssClassObtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente. (Se hereda de WebControl).
Propiedad públicaDataItemContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control).
Propiedad públicaDataKeysContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control).
Propiedad públicaDataMemberObtiene o establece el nombre de la lista de datos a la que se enlaza el control enlazado a datos, en los casos en que el origen de datos contiene más de una lista distinta de elementos de datos.
Propiedad públicaDataSourceObtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos. (Se hereda de BaseDataBoundControl).
Propiedad públicaDataSourceIDObtiene o establece el Id. del control del cual el control enlazado a datos recupera su lista de elementos de datos. (Invalida a BaseDataBoundControl.DataSourceID).
Propiedad públicaDataSourceObjectObtiene un objeto que implementa la interfaz IDataSource, que proporciona acceso al contenido de datos del objeto.
Propiedad protegidaDesignModeObtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
Propiedad públicaEnabledObtiene o establece un valor que indica si el control de servidor web está habilitado. (Se hereda de WebControl).
Propiedad públicaEnableThemingObtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de WebControl).
Propiedad públicaEnableViewStateObtiene o establece un valor que indica si el control de servidor debe mantener su estado de vista y el de los controles secundarios que contiene, en el cliente que realiza la solicitud. (Se hereda de Control).
Propiedad protegidaEventsObtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control).
Propiedad públicaFontObtiene las propiedades de fuente asociadas al control de servidor web. (Se hereda de WebControl).
Propiedad públicaForeColorObtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Se hereda de WebControl).
Propiedad públicaHasAttributesObtiene un valor que indica si el control tiene establecido algún atributo. (Se hereda de WebControl).
Propiedad protegidaHasChildViewStateObtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Se hereda de Control).
Propiedad públicaHeightObtiene o establece el alto del control de servidor Web. (Se hereda de WebControl).
Propiedad públicaIDObtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
Propiedad protegidaIdSeparatorInfraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
Propiedad protegidaInitializedObtiene un valor que indica si el control enlazado a datos está inicializado. (Se hereda de BaseDataBoundControl).
Propiedad protegidaIsBoundUsingDataSourceIDObtiene un valor que indica si la propiedad DataSourceID está establecida. (Se hereda de BaseDataBoundControl).
Propiedad protegidaIsChildControlStateClearedObtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
Propiedad protegidaIsDataBindingAutomaticObtiene un valor que indica el enlace a datos es automático. (Se hereda de BaseDataBoundControl).
Propiedad protegidaIsEnabledObtiene un valor que indica si está habilitado el control. (Se hereda de WebControl).
Propiedad protegidaIsTrackingViewStateObtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Se hereda de Control).
Propiedad protegidaIsUsingModelBindersObtiene un valor que indica si se usa el enlace de modelo. (Invalida a BaseDataBoundControl.IsUsingModelBinders).
Propiedad protegidaIsViewStateEnabledObtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
Propiedad públicaItemTypeObtiene o establece el nombre del tipo de elemento de datos para el enlace de datos fuertemente tipado.
Propiedad protegidaLoadViewStateByIDObtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Se hereda de Control).
Propiedad públicaNamingContainerObtiene 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 Control.ID. (Se hereda de Control).
Propiedad públicaPageObtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control).
Propiedad públicaParentObtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
Propiedad públicaRenderingCompatibilityObtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control).
Propiedad protegidaRequiresDataBindingObtiene o establece un valor que indica si se debe llamar al método DataBind. (Se hereda de BaseDataBoundControl).
Propiedad protegidaSelectArgumentsObtiene un objeto DataSourceSelectArguments que utiliza el control enlazado a datos al recuperar los datos de un control de origen de datos.
Propiedad públicaSelectMethodNombre del método al que se va a llamar para leer datos.
Propiedad públicaSiteObtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Se hereda de Control).
Propiedad públicaSkinIDObtiene o establece la máscara que se va a aplicar al control. (Se hereda de WebControl).
Propiedad públicaStyleObtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web. (Se hereda de WebControl).
Propiedad públicaSupportsDisabledAttributeObtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML presentado cuando el valor de la propiedad IsEnabled del control es false. (Se hereda de BaseDataBoundControl).
Propiedad públicaTabIndexObtiene o establece el índice de tabulación del control de servidor web. (Se hereda de WebControl).
Propiedad protegidaTagKeyObtiene el valor HtmlTextWriterTag correspondiente a este control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad protegidaTagNameObtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaTemplateControlObtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
Propiedad públicaTemplateSourceDirectoryObtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control).
Propiedad públicaToolTipObtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web. (Se hereda de WebControl).
Propiedad públicaUniqueIDObtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control).
Propiedad públicaValidateRequestModeObtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Se hereda de Control).
Propiedad protegidaViewStateObtiene 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. (Se hereda de Control).
Propiedad protegidaViewStateIgnoresCaseObtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control).
Propiedad públicaViewStateModeObtiene o establece el modo del estado de vista de este control. (Se hereda de Control).
Propiedad públicaVisibleObtiene o establece un valor que indica si un control de servidor se debe representar como interfaz de usuario en la página. (Se hereda de Control).
Propiedad públicaWidthObtiene o establece el ancho del control de servidor web. (Se hereda de WebControl).
Arriba

  NombreDescripción
Método protegidoAddAttributesToRenderAgrega atributos y estilos HTML que deben presentarse al objeto HtmlTextWriterTag especificado. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoAddedControlSe le llama una vez que se ha agregado un control secundario a la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoAddParsedSubObjectIndica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega dicho elemento al objeto ControlCollection del control de servidor. (Se hereda de Control).
Método públicoApplyStyleCopia 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. (Se hereda de WebControl).
Método públicoApplyStyleSheetSkinAplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control).
Método protegidoBeginRenderTracingComienza el seguimiento en tiempo de diseño de los datos de representación. (Se hereda de Control).
Método protegidoBuildProfileTreeInfraestructura. 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. (Se hereda de Control).
Método protegidoClearCachedClientIDInfraestructura. Establece en null el valor de ClientID almacenado en caché. (Se hereda de Control).
Método protegidoClearChildControlStateElimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildStateElimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildViewStateElimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearEffectiveClientIDModeInfraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control).
Método protegidoConfirmInitStateEstablece el estado inicializado del control enlazado a datos. (Se hereda de BaseDataBoundControl).
Método públicoCopyBaseAttributesCopia 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. (Se hereda de WebControl).
Método protegidoCreateChildControlsLo llama el marco de trabajo de las páginas ASP.NET para indicar a los controles de servidor que utilizan la implementación basada en la composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos. (Se hereda de Control).
Método protegidoCreateControlCollectionCrea un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de Control).
Método protegidoCreateControlStyleCrea el objeto de estilo que utiliza la clase WebControl de forma interna para implementar todas las propiedades relacionadas con el estilo. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoCreateDataSourceSelectArgumentsCrea un objeto DataSourceSelectArguments predeterminado utilizado por el control enlazado a datos si no se especifica ningún argumento.
Método públicoDataBind()Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Se hereda de BaseDataBoundControl).
Método protegidoDataBind(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. (Se hereda de Control).
Método protegidoDataBindChildrenEnlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
Método públicoDisposeHabilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control).
Método protegidoEndRenderTracingFinaliza el seguimiento en tiempo de diseño de los datos de representación. (Se hereda de Control).
Método protegidoEnsureChildControlsDetermina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control).
Método protegidoEnsureDataBoundLlama al método DataBind si se establece la propiedad DataSourceID y el control enlazado a datos está marcado de forma que requiera el enlace. (Se hereda de BaseDataBoundControl).
Método protegidoEnsureIDCrea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindControl(String)Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control).
Método protegidoFindControl(String, Int32)Infraestructura. 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. (Se hereda de Control).
Método públicoFocusEstablece el foco de entrada en un control. (Se hereda de Control).
Método protegidoGetDataRecupera un objeto DataSourceView que utiliza el control enlazado a datos para realizar operaciones con los datos.
Método protegidoGetDataSourceRecupera la interfaz IDataSource a la que se asocia el control enlazado a datos, si existe.
Método protegidoGetDesignModeStateInfraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetRouteUrl(Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetUniqueIDRelativeToDevuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control).
Método públicoHasControlsDetermina si el control de servidor contiene controles secundarios. (Se hereda de Control).
Método protegidoHasEventsDevuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control).
Método protegidoIsLiteralContentInfraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control).
Método protegidoLoadControlStateRestaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState. (Se hereda de Control).
Método protegidoLoadViewStateRestaura la información sobre el estado de vista de una solicitud de página anterior guardada por el método SaveViewState. (Invalida a WebControl.LoadViewState(Object)).
Método protegidoMapPathSecureRecupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Se hereda de Control).
Método protegidoMarkAsDataBoundEstablece el estado del control en estado de vista como enlazado correctamente a los datos.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoMergeStyleCopia 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. (Se hereda de WebControl).
Método protegidoOnBubbleEventDetermina si el evento del control de servidor debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario de la página. (Se hereda de Control).
Método protegidoOnCreatingModelDataSourceGenera el evento CreatingModelDataSource.
Método protegidoOnDataBindingGenera el evento DataBinding. (Se hereda de Control).
Método protegidoOnDataBoundGenera el evento DataBound. (Se hereda de BaseDataBoundControl).
Método protegidoOnDataPropertyChangedVuelve a enlazar el control enlazado a datos a sus datos después de un cambio en una de las propiedades de identificación del origen de datos base. (Invalida a BaseDataBoundControl.OnDataPropertyChanged()).
Método protegidoOnDataSourceViewChangedGenera el evento DataSourceViewChanged.
Método protegidoOnInitControla el evento Init. (Se hereda de BaseDataBoundControl).
Método protegidoOnLoadControla el evento Control.Load. (Invalida a Control.OnLoad(EventArgs)).
Método protegidoOnPagePreLoadEstablece el estado inicializado del control enlazado a datos antes de cargar el control. (Invalida a BaseDataBoundControl.OnPagePreLoad(Object, EventArgs)).
Método protegidoOnPreRenderControla el evento PreRender. (Se hereda de BaseDataBoundControl).
Método protegidoOnUnloadGenera el evento Unload. (Se hereda de Control).
Método protegidoOpenFileObtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control).
Método protegidoPerformDataBindingCuando se reemplaza en una clase derivada, enlaza los datos del origen de datos al control.
Método protegidoPerformSelectRecupera los datos del origen de datos asociado. (Invalida a BaseDataBoundControl.PerformSelect()).
Método protegidoRaiseBubbleEventAsigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
Método protegidoRemovedControlSe le llama una vez que se ha quitado un control secundario de la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoRenderPresenta el control en el sistema de escritura HTML especificado. (Se hereda de WebControl).
Método públicoRenderBeginTagRepresenta la etiqueta HTML de apertura del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoRenderChildrenEnvía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente. (Se hereda de Control).
Método protegidoRenderContentsRepresenta el contenido del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método públicoRenderControl(HtmlTextWriter)Envía el contenido del control de servidor a un objeto HtmlTextWriter que se proporciona y almacena la información de traza sobre el control si dicha traza está habilitada. (Se hereda de Control).
Método protegidoRenderControl(HtmlTextWriter, ControlAdapter)Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Se hereda de Control).
Método públicoRenderEndTagPresenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoResolveAdapterObtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control).
Método públicoResolveClientUrlObtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control).
Método públicoResolveUrlConvierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control).
Método protegidoSaveControlStateGuarda los cambios de estado de un control de servidor que se hayan producido desde el momento en que se devolvieron al servidor los datos de la página. (Se hereda de Control).
Método protegidoSaveViewStateGuarda los cambios que se hayan producido en el estado de vista del control desde la devolución de la página al servidor. (Invalida a WebControl.SaveViewState()).
Método protegidoSetDesignModeStateEstablece datos en tiempo de diseño para un control. (Se hereda de Control).
Método públicoSetRenderMethodDelegateInfraestructura. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Se hereda de Control).
Método públicoSetTraceData(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. (Se hereda de Control).
Método públicoSetTraceData(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. (Se hereda de Control).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método protegidoTrackViewStateOrigina el seguimiento de los cambios del estado de vista del control de manera que se puedan almacenar en el objeto StateBag del control. (Invalida a WebControl.TrackViewState()).
Método protegidoValidateDataSourceComprueba que el objeto al que se enlaza un control enlazado a datos es compatible. (Invalida a BaseDataBoundControl.ValidateDataSource(Object)).
Arriba

  NombreDescripción
Evento públicoCallingDataMethodsSe produce mientras se llama a los métodos de datos.
Evento públicoCreatingModelDataSourceSe produce mientras se crea el objeto ModelDataSource.
Evento públicoDataBindingSe produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control).
Evento públicoDataBoundSe produce después de que el control de servidor se enlaza a un origen de datos. (Se hereda de BaseDataBoundControl).
Evento públicoDisposedSe 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. (Se hereda de Control).
Evento públicoInitTiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control).
Evento públicoLoadSe produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control).
Evento públicoPreRenderSe produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control).
Evento públicoUnloadSe produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control).
Arriba

  NombreDescripción
Método de extensión públicoEnablePersistedSelectionPermite conservar la selección en los controles de datos que admiten la selección y paginación. (Definido por DynamicDataExtensions).
Método de extensión públicoFindDataSourceControlDevuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindFieldTemplateDevuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindMetaTableDevuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.GetAttributeInfraestructura. Obtiene un atributo del control Web con el nombre especificado. (Se hereda de WebControl).
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.SetAttributeEstablece un atributo del control Web con el nombre y el valor especificados. (Se hereda de WebControl).
Implementación explícita de interfacesPropiedad privadaIControlBuilderAccessor.ControlBuilderPara obtener una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.GetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetOwnerControlInfraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIControlDesignerAccessor.UserDataPara obtener una descripción de este miembro, vea IControlDesignerAccessor.UserData. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.DataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.DataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.HasDataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.ExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.Expressions. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.HasExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.HasExpressions. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIParserAccessor.AddParsedSubObjectPara obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
Arriba

La clase DataBoundControl es la clase base que usan los controles ASP.NET que recuperan datos en formato tabular o de lista de un control de origen de datos ASP.NET y enlazan los elementos de la interfaz de usuario del control a los datos para presentación. Los controles enlazados a datos compuestos como GridView, DetailsView y FormView; los controles enlazados a datos en estilo de lista como BulletedList y CheckBoxList; y otros controles como AdRotator se derivan de DataBoundControl.

Los desarrolladores de páginas no utilizan directamente la clase DataBoundControl; en su lugar, usan controles que se derivan de esta clase.

Los desarrolladores de controles amplían esta clase para crear controles enlazados a datos que funcionan con clases que implementan la interfaz IDataSource y clases que se derivan de las clases DataSourceControl y DataSourceView. Cuando derive una clase de la clase DataBoundControl, reemplace el método PerformDataBinding para enlazar los elementos de interfaz de usuario de su control a los datos recuperados por el método GetData. En la mayoría de los casos, el método PerformDataBinding es el único que reemplazará en su clase derivada.

Para los controles enlazados a datos ASP.NET 2.0, el método PerformSelect es el equivalente del método DataBind y se le llama para enlazar los datos en tiempo de ejecución. El método PerformSelect llama a los métodos GetData y PerformDataBinding.

En el ejemplo de código siguiente se muestra cómo derivar una clase de la clase DataBoundControl para crear un control enlazado a datos personalizado. El control TextBoxSet crea un control TextBox para cada elemento de datos recuperado de su control de origen de datos asociado y lo enlaza al valor del elemento de datos en tiempo de ejecución. La implementación actual del método Render representa los controles TextBox como una lista no ordenada.


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();                       
        }
    }
}


En el ejemplo de código siguiente se muestra cómo utilizar el control TextBoxSet, definido en el ejemplo anterior, y cómo se enlaza a un control AccessDataSource.


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

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft