Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

CheckBoxField classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)


public class CheckBoxField : BoundField

NomDescription
System_CAPS_pubmethodCheckBoxField()

Initialise une nouvelle instance de la classe CheckBoxField.

NomDescription
System_CAPS_pubpropertyAccessibleHeaderText

Obtient ou définit le texte affiché en tant que le AbbreviatedText valeur de propriété dans des contrôles.(Hérité de DataControlField.)

System_CAPS_pubpropertyApplyFormatInEditMode

Remplace le BoundField.ApplyFormatInEditMode propriété. Cette propriété n’est pas pris en charge par le CheckBoxField (classe).(Remplace BoundField.ApplyFormatInEditMode.)

System_CAPS_protpropertyControl

Obtient une référence au contrôle de données qui le DataControlField objet est associé.(Hérité de DataControlField.)

System_CAPS_pubpropertyControlStyle

Obtient le style des contrôles serveur Web contenus dans le DataControlField objet.(Hérité de DataControlField.)

System_CAPS_pubpropertyConvertEmptyStringToNull

Remplace le BoundField.ConvertEmptyStringToNull propriété. Cette propriété n’est pas pris en charge par le CheckBoxField (classe).(Remplace BoundField.ConvertEmptyStringToNull.)

System_CAPS_pubpropertyDataField

Obtient ou définit le nom du champ de données à lier à la CheckBoxField objet.(Remplace BoundField.DataField.)

System_CAPS_pubpropertyDataFormatString

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 pris en charge par le CheckBoxField (classe).(Remplace BoundField.DataFormatString.)

System_CAPS_protpropertyDesignMode

Obtient une valeur qui indique si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.(Hérité de DataControlField.)

System_CAPS_pubpropertyFooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyFooterText

Obtient ou définit le texte qui est affiché dans l’élément de pied de page d’un champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyHeaderImageUrl

Obtient ou définit l’URL d’une image qui est affichée dans l’élément d’en-tête d’un champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyHeaderStyle

Obtient ou définit le style de l’en-tête du champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyHeaderText

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

System_CAPS_pubpropertyHtmlEncode

Remplace le BoundField.HtmlEncode propriété. Cette propriété n’est pas pris en charge par le CheckBoxField (classe).(Remplace BoundField.HtmlEncode.)

System_CAPS_pubpropertyHtmlEncodeFormatString

Obtient ou définit une valeur qui indique si le texte mis en forme doit être codé en HTML avant qu’il s’affiche.(Remplace BoundField.HtmlEncodeFormatString.)

System_CAPS_pubpropertyInsertVisible

Obtient une valeur indiquant si le DataControlField objet est visible lorsque son contrôle lié aux données de parent est en mode insertion.(Hérité de DataControlField.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur indiquant si le DataControlField objet enregistre les modifications apportées à son état d’affichage.(Hérité de DataControlField.)

System_CAPS_pubpropertyItemStyle

Obtient le style de tout contenu basé sur le texte affiché par un champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyNullDisplayText

Obtient ou définit le texte affiché pour un champ lorsque la valeur du champ est null. Cette propriété n’est pas pris en charge par le CheckBoxField (classe).(Remplace BoundField.NullDisplayText.)

System_CAPS_pubpropertyReadOnly

Obtient ou définit une valeur indiquant si la valeur du champ peut être modifiée en mode édition.(Hérité de BoundField.)

System_CAPS_pubpropertyShowHeader

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

System_CAPS_pubpropertySortExpression

Obtient ou définit une expression de tri qui est utilisée par un contrôle de source de données pour trier les données.(Hérité de DataControlField.)

System_CAPS_protpropertySupportsHtmlEncode

Obtient une valeur booléenne indiquant si le contrôle prend en charge le codage HTML.(Remplace BoundField.SupportsHtmlEncode.)

System_CAPS_pubpropertyText

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

System_CAPS_pubpropertyValidateRequestMode

Obtient ou définit une valeur qui détermine si le contrôle valide l’entrée du client ou non.(Hérité de BoundField.)

System_CAPS_protpropertyViewState

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

System_CAPS_pubpropertyVisible

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

NomDescription
System_CAPS_protmethodCloneField()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Crée une copie de l’utilisateur actuel DataControlField-objet dérivé.(Hérité de DataControlField.)

System_CAPS_protmethodCopyProperties(DataControlField)

Copie les propriétés de l’utilisateur actuel CheckBoxField objet spécifié DataControlField objet.(Remplace BoundField.CopyProperties(DataControlField).)

System_CAPS_protmethodCreateField()

Crée un objet CheckBoxField vide.(Remplace BoundField.CreateField().)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)
System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_protmethodFormatDataValue(Object, Boolean)

Met en forme la valeur du champ spécifié d’une cellule dans le BoundField objet.(Hérité de BoundField.)

System_CAPS_protmethodGetDesignTimeValue()

Récupère la valeur utilisée pour la valeur du champ lors du rendu du CheckBoxField objet dans un concepteur.(Remplace BoundField.GetDesignTimeValue().)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodGetValue(Control)

Récupère la valeur du champ lié à la BoundField objet.(Hérité de BoundField.)

System_CAPS_pubmethodInitialize(Boolean, Control)

Initialise le BoundField objet.(Hérité de BoundField.)

System_CAPS_pubmethodInitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialise le spécifié TableCell objet à l’état de ligne spécifié.(Hérité de BoundField.)

System_CAPS_protmethodInitializeDataCell(DataControlFieldCell, DataControlRowState)

Initialise le spécifié DataControlFieldCell objet à l’état de ligne spécifié.(Remplace BoundField.InitializeDataCell(DataControlFieldCell, DataControlRowState).)

System_CAPS_protmethodLoadViewState(Object)

Restaure les informations d’état d’affichage précédemment stockées pour ce champ.(Hérité de BoundField.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnDataBindField(Object, EventArgs)

Lie la valeur d’un champ à une case à cocher dans la CheckBoxField objet.(Remplace BoundField.OnDataBindField(Object, EventArgs).)

System_CAPS_protmethodOnFieldChanged()

Déclenche l'événement FieldChanged.(Hérité de DataControlField.)

System_CAPS_protmethodSaveViewState()

Enregistre les modifications apportées à la DataControlField état d’affichage depuis la publication de la page sur le serveur.(Hérité de DataControlField.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente ce DataControlField objet.(Hérité de DataControlField.)

System_CAPS_protmethodTrackViewState()

Provoque la DataControlField objet à suivre les modifications apportées à son état d’affichage afin qu’ils puissent être stockées dans le contrôle ViewState propriété et être persistantes entre les demandes pour la même page.(Hérité de DataControlField.)

System_CAPS_pubmethodValidateSupportsCallback()

Détermine si les contrôles contenus dans un CheckBoxField des rappels de prise en charge de l’objet.(Remplace BoundField.ValidateSupportsCallback().)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Restaure l’état d’affichage enregistré précédemment du champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Enregistre les modifications apportées à la DataControlField état d’affichage depuis la publication de la page sur le serveur.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Provoque la DataControlField objet à suivre les modifications apportées à son état d’affichage afin qu’ils puissent être stockées dans le contrôle ViewState propriété et être persistantes entre les demandes pour la même page.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataSourceViewSchemaAccessor.DataSourceViewSchema

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient ou définit le schéma associé à cet objet DataControlField.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une valeur indiquant si le DataControlField objet enregistre les modifications apportées à son état d’affichage.(Hérité de DataControlField.)

The T:System.Web.UI.WebControls.CheckBoxField class is used by data-bound controls (such as T:System.Web.UI.WebControls.GridView and T:System.Web.UI.WebControls.DetailsView) to display the value of a Boolean data field in a check box. The T:System.Web.UI.WebControls.CheckBoxField object is displayed differently depending on the data-bound control in which it is used. For example, the T:System.Web.UI.WebControls.GridView control displays a T:System.Web.UI.WebControls.CheckBoxField object as a column, while the T:System.Web.UI.WebControls.DetailsView control displays it as a row.

System_CAPS_noteRemarque

A check box is disabled (read-only) until the data-bound control displays a record that contains the check box in edit mode. For more information on how to put a record into edit mode, see the documentation for the parent control that contains the T:System.Web.UI.WebControls.CheckBoxField object.

To specify the field to display in a T:System.Web.UI.WebControls.CheckBoxField object, set the P:System.Web.UI.WebControls.BoundField.DataField property with the field's name.

System_CAPS_noteRemarque

Because a check box can display only a selected or an unselected state, a T:System.Web.UI.WebControls.CheckBoxField object can be bound only to a field with a Boolean data type or a string that can be parsed by M:System.Boolean.Parse(System.String).

You can display a caption next to each check box by setting the P:System.Web.UI.WebControls.CheckBoxField.Text property. A T:System.Web.UI.WebControls.CheckBoxField object is hidden in a data-bound control when the P:System.Web.UI.WebControls.DataControlField.Visible property is set to false. To prevent the value of a field from being modified in edit mode, set the P:System.Web.UI.WebControls.BoundField.ReadOnly property to true. In data-bound controls that support inserting records (such as the T:System.Web.UI.WebControls.DetailsView control), you can hide a T:System.Web.UI.WebControls.CheckBoxField object in insert mode by setting the P:System.Web.UI.WebControls.DataControlField.InsertVisible property to false.

You can customize the header and footer sections of a T:System.Web.UI.WebControls.CheckBoxField object. To display a caption in the header or footer sections, set the P:System.Web.UI.WebControls.DataControlField.HeaderText or P:System.Web.UI.WebControls.DataControlField.FooterText properties, respectively. Instead of displaying text in the header section, you can display an image by setting the P:System.Web.UI.WebControls.DataControlField.HeaderImageUrl property. The header section can be hidden in the T:System.Web.UI.WebControls.CheckBoxField object by setting the P:System.Web.UI.WebControls.DataControlField.ShowHeader property to false.

System_CAPS_noteRemarque

Some data-bound controls (such as the T:System.Web.UI.WebControls.GridView control) can show or hide only the entire header section of the control. These data-bound controls do not support the P:System.Web.UI.WebControls.DataControlField.ShowHeader property for an individual bound field. To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

You also can customize the appearance of the T:System.Web.UI.WebControls.CheckBoxField object (font color, background color, and so on) by setting the style properties for the different parts of the field. The following table lists the different style properties.

Style property

Description

ControlStyle

The style settings for the child Web server controls of the T:System.Web.UI.WebControls.CheckBoxField object.

FooterStyle

The style settings for the footer section of the T:System.Web.UI.WebControls.CheckBoxField object.

HeaderStyle

The style settings for the header section of the T:System.Web.UI.WebControls.CheckBoxField object.

ItemStyle

The style settings for the data items in the T:System.Web.UI.WebControls.CheckBoxField object.

The following code example demonstrates how to use a T:System.Web.UI.WebControls.CheckBoxField object in a T:System.Web.UI.WebControls.GridView control to display a field from a Microsoft SQL Server data source with a Boolean data type.


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

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: