Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este tema aún no ha recibido ninguna valoración - Valorar este tema

DetailsView (Clase)

.NET Framework 4

Muestra los valores de un único registro de un origen de datos en una tabla, donde cada fila de la tabla representa un campo del registro. El control DetailsView permite editar, eliminar e insertar registros.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.CompositeDataBoundControl
            System.Web.UI.WebControls.DetailsView

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)
C#
C++
F#
VB
Copiar 
[ControlValuePropertyAttribute("SelectedValue")]
public class DetailsView : CompositeDataBoundControl, 
	IDataItemContainer, INamingContainer, ICallbackContainer, ICallbackEventHandler, IPostBackEventHandler, 
	IPostBackContainer, IDataBoundItemControl, IDataBoundControl, IFieldControl
ASP.NET
Copiar 
<asp:DetailsView />

El tipo DetailsView expone los siguientes miembros.

  Nombre Descripción
Método público DetailsView Inicializa una nueva instancia de la clase DetailsView.
Arriba
  Nombre Descripción
Propiedad pública AccessKey Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Se hereda de WebControl).
Propiedad protegida Adapter Obtiene el adaptador específico del explorador para el control. (Se hereda de Control).
Propiedad pública AllowPaging Obtiene o establece un valor que indica si la característica de paginación está habilitada.
Propiedad pública AlternatingRowStyle Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de las filas de datos alternas en un control DetailsView.
Propiedad pública AppRelativeTemplateSourceDirectory Obtiene 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ública Attributes Obtiene 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ública AutoGenerateDeleteButton Obtiene o establece un valor que indica si el control integrado para eliminar el registro actual se muestra en un control DetailsView.
Propiedad pública AutoGenerateEditButton Obtiene o establece un valor que indica si los controles integrados que permiten editar el registro actual se muestran en un control DetailsView.
Propiedad pública AutoGenerateInsertButton Obtiene o establece un valor que indica si los controles integrados que permiten insertar un nuevo registro se muestran en un control DetailsView.
Propiedad pública AutoGenerateRows Obtiene o establece un valor que indica si se generan automáticamente campos de fila para cada campo del origen de datos y se muestran en un control DetailsView.
Propiedad pública BackColor Obtiene o establece el color de fondo del control de servidor web. (Se hereda de WebControl).
Propiedad pública BackImageUrl Obtiene o establece la dirección URL de una imagen que se va a mostrar en el fondo de un control DetailsView.
Propiedad pública BindingContainer Infraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
Propiedad pública BorderColor Obtiene o establece el color de borde del control Web. (Se hereda de WebControl).
Propiedad pública BorderStyle Obtiene o establece el estilo del borde del control de servidor web. (Se hereda de WebControl).
Propiedad pública BorderWidth Obtiene o establece el ancho del borde del control de servidor web. (Se hereda de WebControl).
Propiedad pública BottomPagerRow Obtiene un objeto DetailsViewRow que representa la fila de paginación inferior de un control DetailsView.
Propiedad pública Caption Obtiene o establece el texto que se va a representar en un elemento de título HTML de un control DetailsView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.
Propiedad pública CaptionAlign Obtiene o establece la posición horizontal o vertical del elemento de título HTML de un control DetailsView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.
Propiedad pública CellPadding Obtiene o establece la cantidad de espacio entre el contenido de una celda y el borde de la misma.
Propiedad pública CellSpacing Obtiene o establece la cantidad de espacio entre las celdas.
Propiedad protegida ChildControlsCreated Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control).
Propiedad pública ClientID Obtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control).
Propiedad pública ClientIDMode Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control).
Propiedad protegida ClientIDSeparator Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
Propiedad pública CommandRowStyle Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de una fila de comandos de un control DetailsView.
Propiedad protegida Context Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control).
Propiedad pública Controls Obtiene una colección de los controles secundarios dentro del control enlazado a datos compuesto. (Se hereda de CompositeDataBoundControl).
Propiedad pública ControlStyle Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad pública ControlStyleCreated Obtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad pública CssClass Obtiene o establece la clase hoja de estilo en cascada (CSS) presentada por el control de servidor web en el cliente. (Se hereda de WebControl).
Propiedad pública CurrentMode Obtiene el modo de entrada de datos actual del control DetailsView.
Propiedad pública DataItem Obtiene el elemento de datos enlazado al control DetailsView.
Propiedad pública DataItemContainer Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control).
Propiedad pública DataItemCount Obtiene el número de elementos del origen de datos subyacente.
Propiedad pública DataItemIndex Obtiene el índice del elemento que se muestra en un control DetailsView procedente del origen de datos subyacente.
Propiedad pública DataKey Obtiene un objeto DataKey que representa la clave principal del registro mostrado.
Propiedad pública DataKeyNames Obtiene o establece una matriz que contiene los nombres de los campos clave del origen de datos.
Propiedad pública DataKeysContainer Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control).
Propiedad pública DataMember Obtiene 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. (Se hereda de DataBoundControl).
Propiedad pública DataSource Obtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos. (Se hereda de BaseDataBoundControl).
Propiedad pública DataSourceID Obtiene o establece el Id. del control del cual el control enlazado a datos recupera su lista de elementos de datos. (Se hereda de DataBoundControl).
Propiedad pública DataSourceObject Obtiene un objeto que implementa la interfaz IDataSource, que proporciona acceso al contenido de datos del objeto. (Se hereda de DataBoundControl).
Propiedad pública DefaultMode Obtiene o establece el modo de entrada de datos predeterminado del control DetailsView.
Propiedad protegida DesignMode Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
Propiedad pública EditRowStyle Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de las filas de datos cuando un control DetailsView está en modo de edición.
Propiedad pública EmptyDataRowStyle Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de la fila de datos vacía mostrada cuando se enlaza el origen de datos a un control DetailsView que no contiene ningún registro.
Propiedad pública EmptyDataTemplate Obtiene o establece el contenido definido por el usuario para la fila de datos vacía que se representa cuando un control DetailsView se enlaza a un origen de datos que no contiene registros.
Propiedad pública EmptyDataText Obtiene o establece el texto que se mostrará en la fila de datos vacía que se representa cuando un control DetailsView se enlaza a un origen de datos que no contiene registros.
Propiedad pública Enabled Obtiene o establece un valor que indica si el control de servidor web está habilitado. (Se hereda de WebControl).
Propiedad pública EnableModelValidation Obtiene o establece un valor que indica si está habilitada la validación del modelo de datos.
Propiedad pública EnablePagingCallbacks Obtiene o establece un valor que indica si las funciones de devolución de llamada del lado cliente se utilizan para las operaciones de paginación del control DetailsView.
Propiedad pública EnableTheming Obtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de WebControl).
Propiedad pública EnableViewState Obtiene 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 protegida Events Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control).
Propiedad pública FieldHeaderStyle Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de la columna de encabezado en un control DetailsView.
Propiedad pública Fields Obtiene una colección de objetos DataControlField que representan los campos de fila explícitamente declarados en un control DetailsView.
Propiedad pública Font Obtiene las propiedades de fuente asociadas al control de servidor web. (Se hereda de WebControl).
Propiedad pública FooterRow Obtiene un objeto DetailsViewRow que representa la fila de pie de página de un control DetailsView.
Propiedad pública FooterStyle Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila de pie de página en un control DetailsView.
Propiedad pública FooterTemplate Obtiene o establece el contenido definido por el usuario para la fila del pie de página en un control DetailsView.
Propiedad pública FooterText Obtiene o establece el texto que se muestra en la fila del pie de página de un control DetailsView.
Propiedad pública ForeColor Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Se hereda de WebControl).
Propiedad pública GridLines Obtiene o establece el estilo de cuadrícula de un control DetailsView.
Propiedad pública HasAttributes Obtiene un valor que indica si el control tiene establecido algún atributo. (Se hereda de WebControl).
Propiedad protegida HasChildViewState Obtiene 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ública HeaderRow Obtiene un objeto DetailsViewRow que representa la fila de encabezado de un control DetailsView.
Propiedad pública HeaderStyle Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila de encabezado en un control DetailsView.
Propiedad pública HeaderTemplate Obtiene o establece el contenido definido por el usuario para la fila de encabezado en un control DetailsView.
Propiedad pública HeaderText Obtiene o establece el texto que se muestra en la fila de encabezado de un control DetailsView.
Propiedad pública Height Obtiene o establece el alto del control de servidor Web. (Se hereda de WebControl).
Propiedad pública HorizontalAlign Obtiene o establece la alineación horizontal de un control DetailsView en la página.
Propiedad pública ID Obtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
Propiedad protegida IdSeparator Infraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
Propiedad protegida Initialized Obtiene un valor que indica si el control enlazado a datos está inicializado. (Se hereda de BaseDataBoundControl).
Propiedad pública InsertRowStyle Obtiene una referencia al objeto TableItemStyle que le permite establecer el aspecto de las filas de datos de un control DetailsView cuando un control DetailsView está en modo de inserción.
Propiedad protegida IsBoundUsingDataSourceID Obtiene un valor que indica si la propiedad DataSourceID está establecida. (Se hereda de BaseDataBoundControl).
Propiedad protegida IsChildControlStateCleared Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
Propiedad protegida IsEnabled Obtiene un valor que indica si está habilitado el control. (Se hereda de WebControl).
Propiedad protegida IsTrackingViewState Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Se hereda de Control).
Propiedad protegida IsViewStateEnabled Obtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
Propiedad protegida LoadViewStateByID Obtiene 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ública NamingContainer Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad Control.ID. (Se hereda de Control).
Propiedad pública Page Obtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control).
Propiedad pública PageCount Obtiene el número de registros del origen de datos.
Propiedad pública PageIndex Obtiene o establece el índice del registro mostrado.
Propiedad pública PagerSettings Obtiene una referencia al objeto PagerSettings que permite establecer las propiedades de los botones de paginación en un control DetailsView.
Propiedad pública PagerStyle Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila de paginación en un control DetailsView.
Propiedad pública PagerTemplate Obtiene o establece el contenido personalizado de la fila de paginación de un control DetailsView.
Propiedad pública Parent Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
Propiedad pública RenderingCompatibility Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control).
Propiedad protegida RequiresDataBinding Obtiene o establece un valor que indica si se debe llamar al método DataBind. (Se hereda de BaseDataBoundControl).
Propiedad pública Rows Obtiene una colección de objetos DetailsViewRow que representan las filas de datos de un control DetailsView.
Propiedad pública RowsGenerator Obtiene o establece un objeto que implementa la interfaz IAutoFieldGenerator para llenar automáticamente las filas de la vista.
Propiedad pública RowStyle Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de las filas de datos en un control DetailsView.
Propiedad protegida SelectArguments Obtiene un objeto DataSourceSelectArguments que utiliza el control enlazado a datos al recuperar los datos de un control de origen de datos. (Se hereda de DataBoundControl).
Propiedad pública SelectedValue Obtiene el valor clave de los datos del registro actual en un control DetailsView.
Propiedad pública Site Obtiene 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ública SkinID Obtiene o establece la máscara que se va a aplicar al control. (Se hereda de WebControl).
Propiedad pública Style Obtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web. (Se hereda de WebControl).
Propiedad pública SupportsDisabledAttribute Obtiene 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ública TabIndex Obtiene o establece el índice de tabulación del control de servidor web. (Se hereda de WebControl).
Propiedad protegida TagKey Obtiene el valor de HtmlTextWriterTag para el control DetailsView. (Invalida a WebControl.TagKey).
Propiedad protegida TagName Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad pública TemplateControl Obtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
Propiedad pública TemplateSourceDirectory Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control).
Propiedad pública ToolTip Obtiene 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ública TopPagerRow Obtiene un objeto DetailsViewRow que representa la fila de paginación superior de un control DetailsView.
Propiedad pública UniqueID Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control).
Propiedad protegida ViewState Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Se hereda de Control).
Propiedad protegida ViewStateIgnoresCase Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control).
Propiedad pública ViewStateMode Obtiene o establece el modo del estado de vista de este control. (Se hereda de Control).
Propiedad pública Visible Obtiene 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ública Width Obtiene o establece el ancho del control de servidor web. (Se hereda de WebControl).
Arriba
  Nombre Descripción
Método protegido AddAttributesToRender Agrega atributos y estilos HTML que deben presentarse al objeto HtmlTextWriterTag especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido AddedControl Se 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 protegido AddParsedSubObject Indica 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úblico ApplyStyle Copia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método público ApplyStyleSheetSkin Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control).
Método protegido BuildProfileTree Infraestructura. 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 público ChangeMode Cambia el control DetailsView al modo especificado.
Método protegido ClearCachedClientID Infraestructura. Establece en null el valor de ClientID almacenado en caché. (Se hereda de Control).
Método protegido ClearChildControlState Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegido ClearChildState Elimina 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 protegido ClearChildViewState Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control).
Método protegido ClearEffectiveClientIDMode Infraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control).
Método protegido ConfirmInitState Establece el estado inicializado del control enlazado a datos. (Se hereda de BaseDataBoundControl).
Método público CopyBaseAttributes Copia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido CreateAutoGeneratedRow Crea un objeto AutoGeneratedField que representa un campo de fila generado automáticamente mediante las propiedades de campo especificadas.
Método protegido CreateAutoGeneratedRows Crea un conjunto de campos de fila generados automáticamente para el elemento de datos especificado.
Método protegido CreateChildControls() Infraestructura. Crea la jerarquía de controles que se utiliza para procesar un control compuesto enlazado a datos basada en los valores que se almacenan en estado de vista. (Se hereda de CompositeDataBoundControl).
Método protegido CreateChildControls(IEnumerable, Boolean) Crea la jerarquía de controles utilizada para representar el control DetailsView. (Invalida a CompositeDataBoundControl.CreateChildControls(IEnumerable, Boolean)).
Método protegido CreateControlCollection Crea un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de Control).
Método protegido CreateControlStyle Crea un objeto de estilo de tabla predeterminado para el control DetailsView. (Invalida a WebControl.CreateControlStyle()).
Método protegido CreateDataSourceSelectArguments Infraestructura. Crea el objeto DataSourceSelectArguments que se pasa al comando de selección. (Invalida a DataBoundControl.CreateDataSourceSelectArguments()).
Método protegido CreateFieldSet Crea el conjunto completo de los campos de fila generados automáticamente y los definidos por el usuario que se utilizan para generar la jerarquía de controles.
Método protegido CreateRow Crea un objeto DetailsViewRow basándose en el índice del elemento, el tipo de fila y el estado de fila especificados.
Método protegido CreateTable Crea la tabla que contiene el control DetailsView.
Método público DataBind() Infraestructura. Llama al método DataBind de la clase base. (Invalida a BaseDataBoundControl.DataBind()).
Método protegido DataBind(Boolean) Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Se hereda de Control).
Método protegido DataBindChildren Enlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
Método público DeleteItem Elimina el registro actual del origen de datos.
Método público Dispose Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control).
Método protegido EnsureChildControls Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control).
Método protegido EnsureDataBound Infraestructura. Llama al método DataBind después de comprobar que el control de lista de datos requiere enlace de datos, y que se especifica un control de origen de datos válido. (Invalida a BaseDataBoundControl.EnsureDataBound()).
Método protegido EnsureID Crea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control).
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido ExtractRowValues Recupera los valores de cada campo mostrado y los almacena en el objeto IOrderedDictionary especificado.
Método protegido Finalize 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úblico FindControl(String) Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control).
Método protegido FindControl(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úblico Focus Establece el foco de entrada en un control. (Se hereda de Control).
Método protegido GetCallbackResult Devuelve el resultado de un evento de devolución de llamada que tiene como destino un control.
Método protegido GetCallbackScript Infraestructura. Devuelve la cadena de devolución de llamada creada mediante el argumento especificado.
Método protegido GetData Recupera un objeto DataSourceView que utiliza el control enlazado a datos para realizar operaciones con los datos. (Se hereda de DataBoundControl).
Método protegido GetDataSource Recupera la interfaz IDataSource a la que se asocia el control enlazado a datos, si existe. (Se hereda de DataBoundControl).
Método protegido GetDesignModeState Infraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetRouteUrl(Object) Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método público GetRouteUrl(RouteValueDictionary) Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método público GetRouteUrl(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úblico GetRouteUrl(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úblico GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público GetUniqueIDRelativeTo Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control).
Método público HasControls Determina si el control de servidor contiene controles secundarios. (Se hereda de Control).
Método protegido HasEvents Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control).
Método protegido InitializePager Crea la fila de paginación para el control DetailsView.
Método protegido InitializeRow Inicializa el objeto DetailsViewRow especificado.
Método público InsertItem Inserta el registro actual en el origen de datos.
Método público IsBindableType Determina si el tipo de datos especificado se puede enlazar a un campo del control DetailsView.
Método protegido IsLiteralContent Infraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control).
Método protegido LoadControlState Carga el estado de las propiedades del control DetailsView que deben conservarse, incluso cuando la propiedad EnableViewState se establece en false. (Invalida a Control.LoadControlState(Object)).
Método protegido LoadViewState Carga el estado de vista previamente guardado del control DetailsView. (Invalida a WebControl.LoadViewState(Object)).
Método protegido MapPathSecure Recupera 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 protegido MarkAsDataBound Establece el estado del control en estado de vista como enlazado correctamente a los datos. (Se hereda de DataBoundControl).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público MergeStyle Copia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido OnBubbleEvent Determina si el evento del control de servidor Web debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario (UI) de la página. (Invalida a Control.OnBubbleEvent(Object, EventArgs)).
Método protegido OnDataBinding Provoca el evento DataBinding. (Se hereda de Control).
Método protegido OnDataBound Provoca el evento DataBound. (Se hereda de BaseDataBoundControl).
Método protegido OnDataPropertyChanged Vuelve 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. (Se hereda de DataBoundControl).
Método protegido OnDataSourceViewChanged Infraestructura. Genera el evento DataSourceViewChanged. (Invalida a DataBoundControl.OnDataSourceViewChanged(Object, EventArgs)).
Método protegido OnInit Provoca el evento Init. (Invalida a BaseDataBoundControl.OnInit(EventArgs)).
Método protegido OnItemCommand Provoca el evento ItemCommand.
Método protegido OnItemCreated Provoca el evento ItemCreated.
Método protegido OnItemDeleted Provoca el evento ItemDeleted.
Método protegido OnItemDeleting Provoca el evento ItemDeleting.
Método protegido OnItemInserted Provoca el evento ItemInserted.
Método protegido OnItemInserting Provoca el evento ItemInserting.
Método protegido OnItemUpdated Provoca el evento ItemUpdated.
Método protegido OnItemUpdating Provoca el evento ItemUpdating.
Método protegido OnLoad Controla el evento Control.Load. (Se hereda de DataBoundControl).
Método protegido OnModeChanged Provoca el evento ModeChanged.
Método protegido OnModeChanging Provoca el evento ModeChanging.
Método protegido OnPageIndexChanged Provoca el evento PageIndexChanged.
Método protegido OnPageIndexChanging Provoca el evento PageIndexChanging.
Método protegido OnPagePreLoad Establece el estado inicializado del control enlazado a datos antes de cargar el control. (Invalida a DataBoundControl.OnPagePreLoad(Object, EventArgs)).
Método protegido OnPreRender Provoca el evento PreRender. (Invalida a BaseDataBoundControl.OnPreRender(EventArgs)).
Método protegido OnUnload Provoca el evento Unload. (Se hereda de Control).
Método protegido OpenFile Obtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control).
Método protegido PerformDataBinding Infraestructura. Enlaza el origen de datos especificado al control DetailsView. (Invalida a CompositeDataBoundControl.PerformDataBinding(IEnumerable)).
Método protegido PerformSelect Recupera los datos del origen de datos asociado. (Se hereda de DataBoundControl).
Método protegido PrepareControlHierarchy Infraestructura. Configura la jerarquía de controles del control DetailsView.
Método protegido RaiseBubbleEvent Asigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
Método protegido RaiseCallbackEvent Crea los argumentos para el controlador de devolución de llamada en el método GetCallbackEventReference().
Método protegido RaisePostBackEvent Provoca los eventos correspondientes para el control DetailsView cuando devuelve datos al servidor.
Método protegido RemovedControl Se 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 protegido Render Infraestructura. Muestra el control DetailsView en el cliente utilizando el objeto HtmlTextWriter especificado. (Invalida a WebControl.Render(HtmlTextWriter)).
Método público RenderBeginTag Presenta la etiqueta HTML de apertura del control en el sistema de escritura especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido RenderChildren Enví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 protegido RenderContents Presenta el contenido del control en el sistema de escritura especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método público RenderControl(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 protegido RenderControl(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úblico RenderEndTag Presenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido ResolveAdapter Obtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control).
Método público ResolveClientUrl Obtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control).
Método público ResolveUrl Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control).
Método protegido SaveControlState Infraestructura. Guarda el estado de las propiedades del control DetailsView que deben conservarse, incluso cuando la propiedad Control.EnableViewState se establece en false. (Invalida a Control.SaveControlState()).
Método protegido SaveViewState Infraestructura. Guarda el estado de vista actual del control DetailsView. (Invalida a WebControl.SaveViewState()).
Método protegido SetDesignModeState Establece datos en tiempo de diseño para un control. (Se hereda de Control).
Método público SetPageIndex Establece el índice del objeto que se muestra en el controlDetailsView.
Método público SetRenderMethodDelegate Infraestructura. 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úblico ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método protegido TrackViewState Infraestructura. Marca el punto en el que debe comenzar el seguimiento y el almacenamiento de los cambios del estado de vista realizados en el control DetailsView. (Invalida a WebControl.TrackViewState()).
Método público UpdateItem Actualiza el registro actual en el origen de datos.
Método protegido ValidateDataSource Comprueba que el objeto al que se enlaza un control enlazado a datos es compatible. (Se hereda de DataBoundControl).
Arriba
  Nombre Descripción
Evento público DataBinding Se produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control).
Evento público DataBound Se produce después de que el control de servidor se enlaza a un origen de datos. (Se hereda de BaseDataBoundControl).
Evento público Disposed Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Se hereda de Control).
Evento público Init Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control).
Evento público ItemCommand Se desencadena cuando se hace clic en un botón incluido en un control DetailsView.
Evento público ItemCreated Se desencadena cuando se crea un registro en un control DetailsView.
Evento público ItemDeleted Se produce cuando se hace clic en un botón Eliminar de un control DetailsView, pero después de la operación de eliminación.
Evento público ItemDeleting Se produce cuando se hace clic en un botón Eliminar de un control DetailsView, pero antes de la operación de eliminación.
Evento público ItemInserted Se produce cuando se hace clic en un botón Insertar de un control DetailsView, pero después de la operación de inserción.
Evento público ItemInserting Se produce cuando se hace clic en un botón Insertar de un control DetailsView, pero antes de la operación de inserción.
Evento público ItemUpdated Se produce cuando se hace clic en un botón Actualizar de un control DetailsView, pero después de la operación de actualización.
Evento público ItemUpdating Se produce cuando se hace clic en un botón Actualizar de un control DetailsView, pero antes de la operación de actualización.
Evento público Load Se produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control).
Evento público ModeChanged Se produce cuando un control DetailsView intenta cambiar entre el modo de edición, el modo de inserción y el modo de sólo lectura, pero después de actualizar la propiedad CurrentMode.
Evento público ModeChanging Se produce cuando un control DetailsView intenta cambiar entre el modo de edición, el modo de inserción y el modo de sólo lectura, pero antes de actualizar la propiedad CurrentMode.
Evento público PageIndexChanged Se produce cuando el valor de la propiedad PageIndex cambia después de una operación de paginación.
Evento público PageIndexChanging Se produce cuando el valor de la propiedad PageIndex cambia antes de una operación de paginación.
Evento público PreRender Se produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control).
Evento público Unload Se produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control).
Arriba
  Nombre Descripción
Método de extensión público EnableDynamicData(Type) Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado. (Definido por DataControlExtensions).
Método de extensión público EnableDynamicData(Type, Object) Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado. (Definido por DataControlExtensions).
Método de extensión público EnableDynamicData(Type, IDictionary<String, Object>) Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado. (Definido por DataControlExtensions).
Método de extensión público EnablePersistedSelection Permite 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úblico FindDataSourceControl Devuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
Método de extensión público FindFieldTemplate Devuelve 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úblico FindMetaTable Devuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).
Método de extensión público GetDefaultValues Obtiene la colección de los valores predeterminados para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público GetMetaTable Obtiene los metadatos de la tabla para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público SetMetaTable(MetaTable) Sobrecargado. Establece los metadatos de la tabla para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público SetMetaTable(MetaTable, IDictionary<String, Object>) Sobrecargado. Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público SetMetaTable(MetaTable, Object) Sobrecargado. Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público TryGetMetaTable Determina si están disponibles los metadatos de la tabla. (Definido por DynamicDataExtensions).
Arriba
  Nombre Descripción
Implementación explícita de interfaces Método privado IAttributeAccessor.GetAttribute Infraestructura. Obtiene un atributo del control Web con el nombre especificado. (Se hereda de WebControl).
Implementación explícita de interfaces Método privado IAttributeAccessor.SetAttribute Establece un atributo del control Web con el nombre y el valor especificados. (Se hereda de WebControl).
Implementación explícita de interfaces Método privado ICallbackContainer.GetCallbackScript Infraestructura. Crea el script de devolución de llamada para el control DetailsView.
Implementación explícita de interfaces Método privado ICallbackEventHandler.GetCallbackResult Infraestructura. Vea el método GetCallbackResult.
Implementación explícita de interfaces Método privado ICallbackEventHandler.RaiseCallbackEvent Infraestructura. Provoca el evento de devolución de llamada con los argumentos especificados.
Implementación explícita de interfaces Propiedad privada IControlBuilderAccessor.ControlBuilder Para obtener una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder. (Se hereda de Control).
Implementación explícita de interfaces Método privado IControlDesignerAccessor.GetDesignModeState Para obtener una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState. (Se hereda de Control).
Implementación explícita de interfaces Método privado IControlDesignerAccessor.SetDesignModeState Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState. (Se hereda de Control).
Implementación explícita de interfaces Método privado IControlDesignerAccessor.SetOwnerControl Infraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IControlDesignerAccessor.UserData Para obtener una descripción de este miembro, vea IControlDesignerAccessor.UserData. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IDataBindingsAccessor.DataBindings Para obtener una descripción de este miembro, vea IDataBindingsAccessor.DataBindings. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IDataBindingsAccessor.HasDataBindings Para obtener una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IDataBoundControl.DataKeyNames Para obtener una descripción de esta propiedad, vea IDataBoundControl.DataKeyNames.
Implementación explícita de interfaces Propiedad privada IDataBoundControl.DataMember Para obtener una descripción de esta propiedad, vea IDataBoundControl.DataMember.
Implementación explícita de interfaces Propiedad privada IDataBoundControl.DataSource Para obtener una descripción de esta propiedad, vea IDataBoundControl.DataSource.
Implementación explícita de interfaces Propiedad privada IDataBoundControl.DataSourceID Para obtener una descripción de esta propiedad, vea IDataBoundControl.DataSourceID.
Implementación explícita de interfaces Propiedad privada IDataBoundControl.DataSourceObject Para obtener una descripción de esta propiedad, vea IDataBoundControl.DataSourceObject.
Implementación explícita de interfaces Propiedad privada IDataBoundItemControl.DataKey Para obtener una descripción de esta propiedad, vea IDataBoundItemControl.DataKey.
Implementación explícita de interfaces Propiedad privada IDataBoundItemControl.Mode Para obtener una descripción de esta propiedad, vea IDataBoundItemControl.Mode.
Implementación explícita de interfaces Propiedad privada IDataItemContainer.DataItemIndex Infraestructura. Para obtener una descripción de este miembro, vea DataItemIndex.
Implementación explícita de interfaces Propiedad privada IDataItemContainer.DisplayIndex Infraestructura. Para obtener una descripción de este miembro, vea DisplayIndex.
Implementación explícita de interfaces Propiedad privada IExpressionsAccessor.Expressions Para obtener una descripción de este miembro, vea IExpressionsAccessor.Expressions. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IExpressionsAccessor.HasExpressions Para obtener una descripción de este miembro, vea IExpressionsAccessor.HasExpressions. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IFieldControl.FieldsGenerator Para obtener una descripción de esta propiedad, vea IFieldControl.FieldsGenerator.
Implementación explícita de interfaces Método privado IParserAccessor.AddParsedSubObject Para obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
Implementación explícita de interfaces Método privado IPostBackContainer.GetPostBackOptions Infraestructura. Para obtener una descripción de este miembro, vea IPostBackContainer.GetPostBackOptions.
Implementación explícita de interfaces Método privado IPostBackEventHandler.RaisePostBackEvent Infraestructura. Para obtener una descripción de este miembro, vea IPostBackEventHandler.RaisePostBackEvent.
Arriba

En este tema:

Introduction

El control DetailsView se utiliza para mostrar un registro de un origen de datos en una tabla, donde cada campo del registro aparece en una fila. Se puede utilizar en combinación con un control GridView para los escenarios de detalles maestros. El control DetailsView admite las características siguientes:

  • Enlace a controles de origen de datos, como SqlDataSource.

  • Funciones de inserción integradas.

  • Funciones de actualización y eliminación integradas.

  • Funciones de paginación integradas.

  • Acceso mediante programación al modelo de objetos DetailsView para establecer propiedades dinámicamente, controlar eventos, etc.

  • Personalización de la apariencia a través de temas y estilos.

Campos de fila

Cada fila de datos del control DetailsView se crea declarando un control de campo. Los distintos tipos de campos de fila determinan el comportamiento de las filas en el control. Los controles de campo se derivan de DataControlField. La siguiente tabla contiene los diferentes tipos de campos de fila que se pueden utilizar.

Tipo de campo de columna

Descripción

BoundField

Muestra el valor de un campo de un origen de datos como texto.

ButtonField

Muestra un botón de comando en el control DetailsView. Esto permite mostrar una fila con un control de botón personalizado, tal como un botón Agregar o Quitar.

CheckBoxField

Muestra una casilla en el control DetailsView. Normalmente, este tipo de campo de fila se utiliza para mostrar campos con un valor booleano.

CommandField

Muestra botones de comandos integrados que permiten realizar operaciones de edición, inserción o eliminación en el control DetailsView.

HyperLinkField

Muestra el valor de un campo de un origen de datos como un hipervínculo. Este tipo de campo de fila permite enlazar un segundo campo a la dirección URL del hipervínculo.

ImageField

Muestra una imagen en el control DetailsView.

TemplateField

Muestra el contenido definido por el usuario para una fila del control DetailsView según una plantilla especificada. Este tipo de campo de fila permite crear un campo de fila personalizado.

De manera predeterminada, la propiedad AutoGenerateRows se establece en true, lo cual permite generar automáticamente un objeto de campo de fila enlazado para cada campo de tipo enlazable del origen de datos. Los tipos enlazables válidos son String, DateTime, Decimal, Guid y el conjunto de tipos primitivos. Cada campo se muestra entonces como texto en una fila, en el orden en el que cada uno aparece en el origen de datos.

La generación automática de las filas proporciona una manera rápida y fácil de mostrar cada campo del registro. Sin embargo, para utilizar las características avanzadas del control DetailsView, deberá declarar explícitamente los campos de fila que se deben incluir en el control DetailsView. Para declarar los campos de fila, primero establezca la propiedad AutoGenerateRows en false. A continuación, agregue etiquetas <Fields> de apertura y cierre entre las etiquetas de apertura y cierre del control DetailsView. Finalmente, indique los campos de fila que desea incluir entre las etiquetas <Fields> de apertura y cierre. Los campos de fila especificados se agregan a la colección Fields en el orden en que aparecen en la lista. La colección Fields permite administrar, mediante programación, los campos de fila del control DetailsView.

Nota Nota

Los campos de fila generados automáticamente no se agregan a la colección Fields.

Nota Nota

Los campos de fila declarados explícitamente se pueden mostrar junto con los campos de fila generados automáticamente. Cuando se utilizan ambos, primero se representan los campos de fila declarados explícitamente, seguidos de los campos de fila generados automáticamente.

Enlace a datos

El control DetailsView se puede enlazar a un control de origen de datos (como el control SqlDataSource o el control ObjectDataSource) o a cualquier colección de orígenes de datos que implemente la interfaz System.Collections.IEnumerable, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, u otros tipos de colección. Utilice uno de los métodos siguientes para enlazar el control DetailsView al tipo de origen de datos adecuado:

  • Para enlazar a un control de origen de datos, establezca la propiedad DataSourceID del control DetailsView en el valor ID del control de origen de datos. El control DetailsView se enlaza automáticamente al control de origen de datos especificado. Éste es el método recomendado para el enlace a datos.

  • Para enlazar a un origen de datos que implementa la interfaz System.Collections.IEnumerable, establezca mediante programación la propiedad DataSource del control DetailsView en el origen de datos y, a continuación, llame al método DataBind.

Para obtener más información sobre el enlace de datos, vea Establecer enlaces a bases de datos.

Seguridad

Este control se puede utilizar para mostrar los datos especificados por el usuario, que pueden incluir script de cliente malintencionado. Compruebe que cualquier información que se envíe desde un cliente no contiene script ejecutable, instrucciones SQL o cualquier otro código antes de mostrarla en la aplicación. ASP .NET proporciona una característica de validación de las solicitudes de introducción de datos para bloquear script y código HTML en los datos introducidos por el usuario. Para obtener más información, vea Información general sobre los ataques mediante scripts. También se proporcionan controles de servidor de validación para evaluar los datos introducidos por el usuario. Para obtener más información, vea Sintaxis de los controles de servidor Validation.

Operaciones de datos

El control DetailsView proporciona muchas funciones integradas que permiten al usuario actualizar, eliminar, insertar y recorrer las páginas de los elementos del control. Si enlaza el control DetailsView a un control de origen de datos, el control DetailsView puede sacar partido de las funciones del control de origen de datos y proporcionar funcionalidades de actualización, eliminación, inserción y paginación automáticas.

Nota Nota

El control DetailsView puede proporcionar compatibilidad con las operaciones de actualización, eliminación, inserción y paginación para otros tipos de orígenes de datos; sin embargo, se deberá proporcionar la implementación para esas operaciones en los controladores de evento apropiados. Para obtener más información, vea ItemDeleting, ItemInserting y ItemUpdating.

El control DetailsView puede agregar automáticamente un campo de fila CommandField con un botón Editar, Eliminar o Nuevo estableciendo las propiedades AutoGenerateEditButton, AutoGenerateDeleteButton o AutoGenerateInsertButton en true, respectivamente. A diferencia del botón Eliminar (que elimina inmediatamente el registro seleccionado), cuando se hace clic en el botón Editar o Nuevo, el control DetailsView entra en modo de edición o inserción, respectivamente. En el modo de edición, el botón Editar se reemplaza por un botón Actualizar y un botón Cancelar. Los controles de entrada que son adecuados para el tipo de datos del campo (tales como un control TextBox o un control CheckBox) se muestran con un valor del campo que el usuario puede modificar. Al hacer clic en el botón Actualizar, se actualiza el registro en el origen de datos; al hacer clic en el botón Cancelar, se abandonan los cambios efectuados. Análogamente, en el modo de inserción, el botón Nuevo se reemplaza por un botón Insertar y otro Cancelar, y se muestran controles de entrada vacíos para que el usuario especifique los valores del nuevo registro.

Nota Nota

También se pueden definir manualmente los botones de los comandos de actualización, eliminación e inserción en un campo de fila ButtonField, CommandField o TemplateField. El control DetailsView reconoce los botones con la propiedad CommandName establecida en "Edit" (Editar), "Update" (Actualizar), "Delete" (Eliminar), "New" (Nuevo), "Insert" (Insertar) o "Cancel" (Cancelar); aun así, es necesario proporcionar la funcionalidad. Para obtener más información, vea ItemDeleting, ItemInserting y ItemUpdating.

El control DetailsView proporciona una característica de paginación que permite al usuario navegar a otros registros del origen de datos. Cuando se encuentra habilitada, se muestra una fila de paginación con controles de navegación de páginas. Para habilitar la paginación, establezca la propiedad AllowPaging en true. La fila de paginación se puede personalizar utilizando las propiedades PagerStyle y PagerSettings.

Personalizar la interfaz de usuario

Se puede personalizar la apariencia del control DetailsView estableciendo las propiedades de estilo de diferentes partes del control. En la tabla siguiente se enumeran las propiedades de estilo que puede establecer.

Propiedad de estilo

Descripción

AlternatingRowStyle

Configuración de estilo de las filas de datos alternas del control DetailsView. Cuando se establece esta propiedad, las filas de datos se muestran en franjas, alternando la configuración de RowStyle y la configuración de AlternatingRowStyle.

CommandRowStyle

La configuración de estilo para la fila que contiene los botones de comando integrados en el control .

EditRowStyle

Configuración de estilo de las filas de datos cuando el control DetailsView está en modo de edición.

EmptyDataRowStyle

Configuración de estilo de la fila de datos vacía que se muestra en el control DetailsView cuando el origen de datos no contiene registros.

FooterStyle

La configuración de estilo para la fila del pie de página.

HeaderStyle

La configuración de estilo para la fila de encabezado.

InsertRowStyle

Configuración de estilo de las filas de datos cuando el control DetailsView está en modo de inserción.

PagerStyle

La configuración de estilo para la fila de paginación.

RowStyle

Configuración de estilo de las filas de datos del control DetailsView. Cuando también se establece la propiedad AlternatingRowStyle, las filas de datos se muestran alternando la configuración de RowStyle y la configuración de AlternatingRowStyle.

FieldHeaderStyle

La configuración de estilo para la columna de encabezado.

Eventos

El control DetailsView proporciona varios eventos que puede utilizar para programar. De esta manera, se puede ejecutar una rutina personalizada siempre que se produzca un evento. En la siguiente tabla se enumeran los eventos admitidos por el control DetailsView. El control DetailsView también hereda estos eventos de sus clases base: DataBinding, DataBound, Disposed, Init, Load, PreRender y Render.

Evento

Descripción

ItemCommand

Se desencadena cuando se hace clic en un botón del control DetailsView.

ItemCreated

Se desencadena después que se hayan creado todos los objetos DetailsViewRow en el control DetailsView. Este evento suele utilizarse para modificar los valores de un registro antes de mostrarlo.

ItemDeleted

Se produce al hacer clic en un botón Eliminar, pero después de que el control DetailsView elimine el registro del origen de datos. Este evento suele utilizarse para comprobar el resultado de la operación de eliminación.

ItemDeleting

Se produce al hacer clic en un botón Eliminar, pero antes de que el control DetailsView elimine el registro del origen de datos. Este evento se utiliza normalmente para cancelar la operación de eliminación.

ItemInserted

Se produce al hacer clic en un botón Insertar, pero después de que el control DetailsView inserte el registro. Este evento suele utilizarse para comprobar los resultados de la operación de inserción.

ItemInserting

Se produce al hacer clic en un botón Insertar, pero antes de que el control DetailsView inserte el registro. Este evento suele utilizarse para cancelar la operación de inserción.

ItemUpdated

Se produce al hacer clic en un botón Actualizar, pero después de que el control DetailsView actualice la fila. Este evento se utiliza normalmente para comprobar los resultados de la operación de actualización.

ItemUpdating

Se produce al hacer clic en un botón Actualizar, pero antes de que el control DetailsView actualice el registro. Este evento se utiliza normalmente para cancelar la operación de actualización.

ModeChanged

Se produce después de que el control DetailsView cambie de modo (modo de edición, inserción o sólo lectura). Este evento se utiliza a menudo para realizar una tarea cuando el control DetailsView cambia los modos.

ModeChanging

Se produce antes de que el control DetailsView cambie de modo (edición, inserción o sólo lectura). Este evento se utiliza a menudo para cancelar un cambio de modo.

PageIndexChanged

Se produce cuando se hace clic en uno de los botones de paginación, pero después de que el control DetailsView se ocupe de la operación de paginación. Normalmente este evento se utiliza cuando se necesita realizar una tarea después de que el usuario navegue a otro registro del control.

PageIndexChanging

Se produce cuando se hace clic en uno de los botones de paginación, pero antes de que el control DetailsView se ocupe de la operación de paginación. Este evento suele utilizarse para cancelar la operación de paginación.

Accesibilidad

Para obtener información sobre cómo configurar este control para que genere un marcado que cumpla las normas de accesibilidad, vea Accesibilidad en Visual Studio y ASP.NET y Controles y accesibilidad en ASP.NET.

Sintaxis de la declaración

Copiar 
<asp:DetailsView
    AccessKey="string"
    AllowPaging="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateInsertButton="True|False"
    AutoGenerateRows="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DefaultMode="ReadOnly|Edit|Insert"
    EmptyDataText="string"
    Enabled="True|False"
    EnablePagingCallbacks="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    FooterText="string"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    HeaderText="string"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDeleted="ItemDeleted event handler"
    OnItemDeleting="ItemDeleting event handler"
    OnItemInserted="ItemInserted event handler"
    OnItemInserting="ItemInserting event handler"
    OnItemUpdated="ItemUpdated event handler"
    OnItemUpdating="ItemUpdating event handler"
    OnLoad="Load event handler"
    OnModeChanged="ModeChanged event handler"
    OnModeChanging="ModeChanging event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <AlternatingRowStyle />
        <CommandRowStyle />
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FieldHeaderStyle />
        <Fields>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Fields>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <InsertRowStyle />
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle        />
</asp:DetailsView>

El ejemplo de código siguiente muestra cómo utilizar para utilizar un control DetailsView en combinación con un control GridView para un escenario de detalles maestros simple. Muestra los detalles de un elemento seleccionado en el control GridView.

C#
VB
Copiar 

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            <asp:GridView ID="GridView1" runat="server" 
              AutoGenerateColumns="False" DataSourceID="Customers"
              DataKeyNames="CustomerID">
              <Columns>
                <asp:CommandField ShowSelectButton="True" />
                <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
                <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              </Columns>
            </asp:GridView>
          </td>
          <td valign="top">
            <asp:DetailsView ID="DetailsView1" runat="server" 
              AutoGenerateRows="True" DataKeyNames="CustomerID"
              DataSourceID="Details" Height="50px" Width="301px">
            </asp:DetailsView>
          </td>
        </tr>
      </table>
      &nbsp;&nbsp;
      <asp:SqlDataSource ID="Details" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
        <SelectParameters>
          <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
            PropertyName="SelectedValue"
            Type="String" />
        </SelectParameters>
      </asp:SqlDataSource>
      <asp:SqlDataSource ID="Customers" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
      </asp:SqlDataSource>
    </div>
  </form>
</body>
</html>

En el ejemplo de código siguiente se muestra cómo utilizar el control DetailsView para agregar, eliminar y editar registros.

C#
VB
Copiar 


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  void CustomerDetail_ItemInserted(object sender, 
    DetailsViewInsertedEventArgs e)
  {
    // Refresh the GridView control after a new record is inserted 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemInserting(object sender, 
    DetailsViewInsertEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.Values.Count; i++)
    {
      if (e.Values[i] != null)
      {
        e.Values[i] = Server.HtmlEncode(e.Values[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemUpdated(object sender, 
    DetailsViewUpdatedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemUpdating(object sender, 
    DetailsViewUpdateEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.NewValues.Count; i++)
    {
      if (e.NewValues[i] != null)
      {
        e.NewValues[i] = Server.HtmlEncode(e.NewValues[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemDeleted(object sender, 
    DetailsViewDeletedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>
      DetailsView Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <h3>
      DetailsView Example</h3>
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the customers//s detailed     -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="CustomersView" DataSourceID="Customers" 
            AutoGenerateColumns="False"
            DataKeyNames="CustomerID" runat="server">
            <HeaderStyle BackColor="Blue" ForeColor="White" />
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" 
                HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" 
                HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="CustomerDetail" 
            DataSourceID="Details" AutoGenerateRows="false"
            AutoGenerateInsertButton="true" 
            AutoGenerateEditButton="true" 
            AutoGenerateDeleteButton="true"
            EmptyDataText="No records." 
            DataKeyNames="CustomerID" GridLines="Both" 
            OnItemInserted="CustomerDetail_ItemInserted"
            OnItemInserting="CustomerDetail_ItemInserting" 
            OnItemUpdated="CustomerDetail_ItemUpdated"
            OnItemUpdating="CustomerDetail_ItemUpdating" 
            OnItemDeleted="CustomerDetail_ItemDeleted"
            runat="server">
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <RowStyle BackColor="White" />
            <AlternatingRowStyle BackColor="LightGray" />
            <EditRowStyle BackColor="LightCyan" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="Address" HeaderText="Address" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
              <asp:BoundField DataField="Phone" HeaderText="Phone" />
              <asp:BoundField DataField="Fax" HeaderText="Fax" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                   -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] 
        FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      runat="server" 
      SelectCommand="SELECT * FROM [Customers] 
        WHERE ([CustomerID] = @CustomerID)"
      DeleteCommand="DELETE FROM [Customers] 
        WHERE [CustomerID] = @CustomerID"
      InsertCommand="INSERT INTO [Customers] ([CustomerID], 
        [CompanyName], [ContactName], [ContactTitle], [Address], 
        [City], [Region], [PostalCode], [Country], [Phone], [Fax]) 
        VALUES (@CustomerID, @CompanyName, @ContactName, @ContactTitle, 
        @Address, @City, @Region, @PostalCode, @Country, @Phone, @Fax)"
      UpdateCommand="UPDATE [Customers] SET [CompanyName] = @CompanyName, 
        [ContactName] = @ContactName, [ContactTitle] = @ContactTitle, 
        [Address] = @Address, [City] = @City, [Region] = @Region, 
        [PostalCode] = @PostalCode, [Country] = @Country, 
        [Phone] = @Phone, [Fax] = @Fax 
        WHERE [CustomerID] = @CustomerID">
      <SelectParameters>
        <asp:ControlParameter ControlID="CustomersView" 
          Name="CustomerID" PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
      <DeleteParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
      </DeleteParameters>
      <UpdateParameters>
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
        <asp:Parameter Name="CustomerID" Type="String" />
      </UpdateParameters>
      <InsertParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
      </InsertParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

El ejemplo de código siguiente muestra cómo agregar, mediante declaración, campos de fila al control DetailsView.

C#
VB
Copiar 

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the store's detailed          -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="GridView1" runat="server" 
            DataSourceID="Customers" AutoGenerateColumns="False" 
            DataKeyNames="CustomerID">
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="DetailsView" runat="server"
            DataSourceID="Details" AutoGenerateRows="false"
            DataKeyNames="CustomerID" >
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
                ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                        -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" runat="server" 
      ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
      <SelectParameters>
        <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
          PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes