Partager via


CheckBoxField Classe

Définition

Représente un champ booléen affiché sous forme de case à cocher dans un contrôle lié aux données.

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
Héritage

Exemples

L’exemple de code suivant montre comment utiliser un CheckBoxField objet dans un GridView contrôle pour afficher un champ à partir d’une source de données Microsoft SQL Server avec un type de données booléen.


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

Remarques

La CheckBoxField classe est utilisée par des contrôles liés aux données (tels que GridView et DetailsView) pour afficher la valeur d’un champ de données booléen dans une case à cocher. L’objet CheckBoxField est affiché différemment en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le GridView contrôle affiche un CheckBoxField objet sous forme de colonne, tandis que le contrôle l’affiche DetailsView sous forme de ligne.

Notes

Une case à cocher est désactivée (en lecture seule) jusqu’à ce que le contrôle lié aux données affiche un enregistrement qui contient la case à cocher en mode édition. Pour plus d’informations sur la façon de placer un enregistrement en mode d’édition, consultez la documentation du contrôle parent qui contient l’objet CheckBoxField .

Pour spécifier le champ à afficher dans un CheckBoxField objet, définissez la DataField propriété avec le nom du champ.

Notes

Étant donné qu’une case à cocher ne peut afficher qu’un état sélectionné ou non sélectionné, un CheckBoxField objet ne peut être lié qu’à un champ avec un type de données booléen ou une chaîne pouvant être analysée par Parse.

Vous pouvez afficher une légende en regard de chaque case à cocher en définissant la Text propriété. Un CheckBoxField objet est masqué dans un contrôle lié aux données lorsque la Visible propriété est définie sur false. Pour empêcher la modification de la valeur d’un champ en mode édition, définissez la ReadOnly propriété truesur . Dans les contrôles liés aux données qui prennent en charge l’insertion d’enregistrements (par exemple, le DetailsView contrôle), vous pouvez masquer un CheckBoxField objet en mode d’insertion en définissant la InsertVisible propriété falsesur .

Vous pouvez personnaliser les sections d’en-tête et de pied de page d’un CheckBoxField objet. Pour afficher une légende dans les sections en-tête ou pied de page, définissez respectivement les propriétés ou FooterText l’en-têteHeaderText. Au lieu d’afficher du texte dans la section d’en-tête, vous pouvez afficher une image en définissant la HeaderImageUrl propriété. La section d’en-tête peut être masquée dans l’objet CheckBoxField en définissant la ShowHeader propriété sur false.

Notes

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement la section d’en-tête entière du contrôle. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété pour un champ lié individuel. Pour afficher ou masquer la section d’en-tête entière d’un contrôle lié aux données (si disponible), utilisez la propriété du ShowHeader contrôle.

Vous pouvez également personnaliser l’apparence de l’objet CheckBoxField (couleur de police, couleur d’arrière-plan, et ainsi de suite) en définissant les propriétés de style pour les différentes parties du champ. Le tableau suivant répertorie les différentes propriétés de style.

Style, propriété Description
ControlStyle Paramètres de style pour les contrôles de serveur Web enfant de l’objet CheckBoxField .
FooterStyle Paramètres de style de la section pied de page de l’objet CheckBoxField .
HeaderStyle Paramètres de style de la section d’en-tête de l’objet CheckBoxField .
ItemStyle Paramètres de style pour les éléments de données de l’objet CheckBoxField .

Constructeurs

CheckBoxField()

Initialise une nouvelle instance de la classe CheckBoxField.

Propriétés

AccessibleHeaderText

Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles.

(Hérité de DataControlField)
ApplyFormatInEditMode

Substitue la propriété ApplyFormatInEditMode. Cette propriété n'est pas prise en charge par la classe CheckBoxField.

Control

Obtient une référence au contrôle de données auquel l'objet DataControlField est associé.

(Hérité de DataControlField)
ControlStyle

Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField.

(Hérité de DataControlField)
ConvertEmptyStringToNull

Substitue la propriété ConvertEmptyStringToNull. Cette propriété n'est pas prise en charge par la classe CheckBoxField.

DataField

Obtient ou définit le nom du champ de données lié à lier à l'objet CheckBoxField.

DataFormatString

Obtient ou définit la chaîne qui spécifie le format d'affichage de la valeur du champ. Cette propriété n'est pas prise en charge par la classe CheckBoxField.

DesignMode

Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.

(Hérité de DataControlField)
FooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.

(Hérité de DataControlField)
FooterText

Obtient ou définit le texte affiché dans l'élément de pied de page d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderImageUrl

Obtient ou définit l'URL d'une image affichée dans l'élément d'en-tête d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderStyle

Obtient ou définit le style de l'en-tête du champ de contrôle de données.

(Hérité de DataControlField)
HeaderText

Obtient ou définit le texte qui s'affiche dans l'en-tête d'un contrôle de données.

(Hérité de BoundField)
HtmlEncode

Substitue la propriété HtmlEncode. Cette propriété n'est pas prise en charge par la classe CheckBoxField.

HtmlEncodeFormatString

Obtient ou définit une valeur qui indique si le texte mis en forme doit être encodé en HTML avant qu'il soit affiché.

InsertVisible

Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion.

(Hérité de DataControlField)
IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
ItemStyle

Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données.

(Hérité de DataControlField)
NullDisplayText

Obtient ou définit le texte affiché pour un champ lorsque la valeur du champ est null. Cette propriété n'est pas prise en charge par la classe CheckBoxField.

ReadOnly

Obtient ou définit une valeur indiquant si la valeur du champ peut être modifiée en mode édition.

(Hérité de BoundField)
ShowHeader

Obtient ou définit une valeur indiquant si l'élément d'en-tête d'un champ de contrôle de données est restitué.

(Hérité de DataControlField)
SortExpression

Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier des données.

(Hérité de DataControlField)
SupportsHtmlEncode

Obtient une valeur Boolean indiquant si le contrôle prend en charge l'encodage HTML.

Text

Obtient ou définit la légende à afficher en regard de chaque case à cocher dans un objet CheckBoxField.

ValidateRequestMode

Obtient ou définit une valeur qui détermine si le contrôle valide l'entrée cliente ou non.

(Hérité de BoundField)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataControlField entre plusieurs demandes de la même page.

(Hérité de DataControlField)
Visible

Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué.

(Hérité de DataControlField)

Méthodes

CloneField()

Crée une copie de l'objet dérivé de DataControlField en cours.

(Hérité de DataControlField)
CopyProperties(DataControlField)

Copie les propriétés de l'objet CheckBoxField actuel vers l'objet DataControlField spécifié.

CreateField()

Crée un objet CheckBoxField vide.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Remplit l'objet IDictionary spécifié avec les valeurs provenant de l'objet DataControlFieldCell spécifié.

FormatDataValue(Object, Boolean)

Met en forme la valeur de champ spécifiée pour une cellule dans l'objet BoundField.

(Hérité de BoundField)
GetDesignTimeValue()

Récupère la valeur utilisée pour la valeur d'un champ lors du rendu de l'objet CheckBoxField dans un concepteur.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetValue(Control)

Récupère la valeur du champ lié à l'objet BoundField.

(Hérité de BoundField)
Initialize(Boolean, Control)

Initialise l'objet BoundField.

(Hérité de BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialise l'objet TableCell spécifié à l'état de ligne spécifié.

(Hérité de BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Initialise l'objet DataControlFieldCell spécifié à l'état de ligne spécifié.

LoadViewState(Object)

Restaure les informations d'état d'affichage précédemment enregistrées pour ce champ.

(Hérité de BoundField)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnDataBindField(Object, EventArgs)

Lie la valeur d'un champ à une case à cocher dans l'objet CheckBoxField.

OnFieldChanged()

Déclenche l’événement FieldChanged.

(Hérité de DataControlField)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
ToString()

Retourne une chaîne qui représente cet objet DataControlField.

(Hérité de DataControlField)
TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)
ValidateSupportsCallback()

Détermine si les contrôles contenus dans un objet CheckBoxField prennent en charge les rappels.

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtient ou définit le schéma associé à cet objet DataControlField.

(Hérité de DataControlField)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données.

(Hérité de DataControlField)
IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
IStateManager.TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)

S’applique à

Voir aussi