Compartir a través de


CheckBoxField Clase

Definición

Representa un campo booleano que se muestra como una casilla en un control enlazado a datos.

public ref class CheckBoxField : System::Web::UI::WebControls::BoundField
public class CheckBoxField : System.Web.UI.WebControls.BoundField
type CheckBoxField = class
    inherit BoundField
Public Class CheckBoxField
Inherits BoundField
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un CheckBoxField objeto en un GridView control para mostrar un campo de un origen de datos Microsoft SQL Server con un tipo de datos booleano.


<%@ 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>CheckBoxField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>CheckBoxField Example</h3>

      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="au_lname"
            headertext="Last Name"/>
                    
          <asp:checkboxfield datafield="contract"
            text="Contract"
            headertext="Contract"/>     
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

<%@ Page language="VB" %>

<!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>CheckBoxField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>CheckBoxField Example</h3>

      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="au_lname"
            headertext="Last Name"/>
                    
          <asp:checkboxfield datafield="contract"
            text="Contract"
            headertext="Contract"/>     
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Comentarios

Los controles enlazados a datos (como GridView y DetailsView) usan la CheckBoxField clase para mostrar el valor de un campo de datos booleano en una casilla de verificación. El CheckBoxField objeto se muestra de forma diferente según el control enlazado a datos en el que se use. Por ejemplo, el GridView control muestra un CheckBoxField objeto como una columna, mientras que el DetailsView control lo muestra como una fila.

Nota

Se deshabilita una casilla (solo lectura) hasta que el control enlazado a datos muestra un registro que contiene la casilla en modo de edición. Para obtener más información sobre cómo colocar un registro en modo de edición, consulte la documentación del control primario que contiene el CheckBoxField objeto .

Para especificar el campo que se va a mostrar en un CheckBoxField objeto, establezca la DataField propiedad con el nombre del campo.

Nota

Dado que una casilla solo puede mostrar un estado seleccionado o no seleccionado, un CheckBoxField objeto solo se puede enlazar a un campo con un tipo de datos booleano o una cadena que puede analizar Parse.

Puede mostrar un título junto a cada casilla estableciendo la Text propiedad . Un CheckBoxField objeto se oculta en un control enlazado a datos cuando la Visible propiedad se establece falseen . Para evitar que el valor de un campo se modifique en modo de edición, establezca la ReadOnly propiedad trueen . En los controles enlazados a datos que admiten la inserción de registros (como el DetailsView control ), puede ocultar un CheckBoxField objeto en modo de inserción estableciendo la InsertVisible propiedad falseen .

Puede personalizar las secciones de encabezado y pie de página de un CheckBoxField objeto . Para mostrar un título en las secciones de encabezado o pie de página, establezca las HeaderText propiedades o FooterText , respectivamente. En lugar de mostrar texto en la sección de encabezado, puede mostrar una imagen estableciendo la HeaderImageUrl propiedad . La sección de encabezado se puede ocultar en el CheckBoxField objeto estableciendo la ShowHeader propiedad falseen .

Nota

Algunos controles enlazados a datos (como el GridView control) pueden mostrar u ocultar solo la sección de encabezado completa del control. Estos controles enlazados a datos no admiten la ShowHeader propiedad para un campo enlazado individual. Para mostrar u ocultar toda la sección de encabezado de un control enlazado a datos (si está disponible), use la propiedad del ShowHeader control.

También puede personalizar la apariencia del CheckBoxField objeto (color de fuente, color de fondo, etc.) estableciendo las propiedades de estilo para las distintas partes del campo. En la tabla siguiente se enumeran las diferentes propiedades de estilo.

Propiedad Style Descripción
ControlStyle La configuración de estilo para los controles secundarios del servidor web del CheckBoxField objeto .
FooterStyle La configuración de estilo de la sección de pie de página del CheckBoxField objeto .
HeaderStyle La configuración de estilo de la sección de encabezado del CheckBoxField objeto.
ItemStyle La configuración de estilo de los elementos de datos del CheckBoxField objeto .

Constructores

CheckBoxField()

Inicializa una nueva instancia de la clase CheckBoxField.

Propiedades

AccessibleHeaderText

Obtiene o establece el texto que se representa como el valor de la propiedad AbbreviatedText en algunos controles.

(Heredado de DataControlField)
ApplyFormatInEditMode

Reemplaza la propiedad ApplyFormatInEditMode. La clase CheckBoxField no admite esta propiedad.

Control

Obtiene una referencia al control de datos al que está asociado el objeto DataControlField.

(Heredado de DataControlField)
ControlStyle

Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField.

(Heredado de DataControlField)
ConvertEmptyStringToNull

Reemplaza la propiedad ConvertEmptyStringToNull. La clase CheckBoxField no admite esta propiedad.

DataField

Obtiene o establece el nombre del campo de datos que se enlaza al objeto CheckBoxField.

DataFormatString

Obtiene o establece la cadena que especifica el formato de presentación del valor del campo. La clase CheckBoxField no admite esta propiedad.

DesignMode

Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño.

(Heredado de DataControlField)
FooterStyle

Obtiene o establece el estilo del pie de página del campo del control de datos.

(Heredado de DataControlField)
FooterText

Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos.

(Heredado de DataControlField)
HeaderImageUrl

Obtiene o establece la dirección URL de una imagen que se muestra en el elemento de encabezado de un campo de control de datos.

(Heredado de DataControlField)
HeaderStyle

Obtiene o establece el estilo del encabezado del campo del control de datos.

(Heredado de DataControlField)
HeaderText

Obtiene o establece el texto que se muestra en el encabezado de un control de datos.

(Heredado de BoundField)
HtmlEncode

Reemplaza la propiedad HtmlEncode. La clase CheckBoxField no admite esta propiedad.

HtmlEncodeFormatString

Obtiene o establece un valor que indica si el texto con formato se debe codificar en HTML antes de mostrarse.

InsertVisible

Obtiene un valor que indica si el objeto DataControlField está visible cuando su control enlazado a datos primario está en modo de inserción.

(Heredado de DataControlField)
IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.

(Heredado de DataControlField)
ItemStyle

Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos.

(Heredado de DataControlField)
NullDisplayText

Obtiene o establece el texto mostrado para un campo cuando el valor del campo es null. La clase CheckBoxField no admite esta propiedad.

ReadOnly

Obtiene o establece un valor que indica si el valor del campo se puede modificar en modo de edición.

(Heredado de BoundField)
ShowHeader

Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos.

(Heredado de DataControlField)
SortExpression

Obtiene o establece una expresión de ordenación utilizada por un control de origen de datos para ordenar los datos.

(Heredado de DataControlField)
SupportsHtmlEncode

Obtiene un valor booleano que indica si el control admite la codificación HTML.

Text

Obtiene o establece el título que se muestra al lado de cada casilla de un objeto CheckBoxField.

ValidateRequestMode

Obtiene o establece un valor que determina si el control valida la entrada de cliente o no.

(Heredado de BoundField)
ViewState

Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataControlField en las distintas solicitudes de la misma página.

(Heredado de DataControlField)
Visible

Obtiene o establece un valor que indica si se representa un campo de control de datos.

(Heredado de DataControlField)

Métodos

CloneField()

Crea una copia duplicada del objeto actual derivado de DataControlField.

(Heredado de DataControlField)
CopyProperties(DataControlField)

Copia las propiedades del objeto CheckBoxField actual al objeto DataControlField especificado.

CreateField()

Crea un objeto CheckBoxField vacío.

Equals(Object)

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

(Heredado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

El objeto IDictionary especificado se rellena con los valores del objeto DataControlFieldCell especificado.

FormatDataValue(Object, Boolean)

Da formato al valor de campo especificado para una celda del objeto BoundField.

(Heredado de BoundField)
GetDesignTimeValue()

Recupera el valor utilizado para el valor del campo al representar el objeto CheckBoxField en un diseñador.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetValue(Control)

Recupera el valor del campo enlazado al objeto BoundField.

(Heredado de BoundField)
Initialize(Boolean, Control)

Inicializa el objeto BoundField.

(Heredado de BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicializa el objeto TableCell especificado en el estado de fila especificado.

(Heredado de BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inicializa el objeto DataControlFieldCell especificado en el estado de fila especificado.

LoadViewState(Object)

Restaura la información de estado de vista almacenada previamente para este campo.

(Heredado de BoundField)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnDataBindField(Object, EventArgs)

Enlaza el valor de un campo a una casilla del objeto CheckBoxField.

OnFieldChanged()

Genera el evento FieldChanged.

(Heredado de DataControlField)
SaveViewState()

Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor.

(Heredado de DataControlField)
ToString()

Devuelve una cadena que representa este objeto DataControlField.

(Heredado de DataControlField)
TrackViewState()

Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de DataControlField)
ValidateSupportsCallback()

Determina si los controles que contiene un objeto CheckBoxField admiten devoluciones de llamada.

Implementaciones de interfaz explícitas

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtiene o establece el esquema asociado a este objeto DataControlField.

(Heredado de DataControlField)
IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.

(Heredado de DataControlField)
IStateManager.LoadViewState(Object)

Restaura el estado de vista que se guardó previamente del campo de control de datos.

(Heredado de DataControlField)
IStateManager.SaveViewState()

Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor.

(Heredado de DataControlField)
IStateManager.TrackViewState()

Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

(Heredado de DataControlField)

Se aplica a

Consulte también