CheckBoxField, classe
TOC
Réduire la table des matières
Développer la table des matières

CheckBoxField, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente un champ booléen affiché comme une 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
public class CheckBoxField extends BoundField
public class CheckBoxField extends BoundField

La classe CheckBoxField est utilisée par les 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'affichage de l'objet CheckBoxField varie en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le contrôle GridView affiche un objet CheckBoxField sous forme de colonne, tandis que le contrôle DetailsView l'affiche sous forme de ligne.

RemarqueRemarque

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 le passage d'un enregistrement en mode édition, consultez la documentation relative au contrôle parent qui contient l'objet CheckBoxField.

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

RemarqueRemarque

Étant donné qu'une case à cocher peut afficher uniquement un état coché ou décoché, un objet CheckBoxField peut être lié uniquement à un champ contenant un type de données Booléen ou une chaîne qui peut être analysée par Parse.

Vous pouvez afficher une légende en regard de chaque case à cocher en définissant la propriété Text. Un objet CheckBoxField est masqué dans un contrôle lié aux données lorsque la propriété Visible a la valeur false. Pour empêcher la valeur d'un champ d'être modifié en mode édition, affectez true à la propriété ReadOnly. Dans les contrôles liés aux données qui prennent en charge l'insertion d'enregistrements (tels que le contrôle DetailsView), vous pouvez masquer un objet en mode insertion CheckBoxField en affectant false à la propriété InsertVisible.

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

RemarqueRemarque

Certains contrôles liés aux données (tels que le contrôle GridView) peuvent uniquement afficher ou masquer l'intégralité de la section d'en-tête du contrôle. Ces contrôles liés aux données ne prennent pas en charge la propriété ShowHeader pour un champ lié. Pour afficher ou masquer l'intégralité de la section d'en-tête d'un contrôle lié aux données (le cas échéant), utilisez la propriété ShowHeader du contrôle.

Vous pouvez également personnaliser l'apparence de l'objet CheckBoxField (couleur de police, couleur d'arrière-plan, etc.) en définissant les propriétés de style des différentes parties du champ. Le tableau suivant énumère les différentes propriétés de style.

Propriété du style

Description

ControlStyle

Paramètres de style pour les contrôles serveur Web enfants de l'objet CheckBoxField.

FooterStyle

Paramètres de style de la section de 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 des éléments de données dans l'objet CheckBoxField.

L'exemple de code suivant illustre l'utilisation d'un objet CheckBoxField dans un contrôle GridView pour afficher un champ provenant d'une source de données Microsoft SQL Server avec un type de données Boolean.


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

<html>
  <body>
    <form 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>


Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2016 Microsoft