Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

CheckBoxField, classe

.NET Framework 4

Autres versions

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

Hiérarchie d'héritage

System.Object
  System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.BoundField
      System.Web.UI.WebControls.CheckBoxField

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

Syntaxe

C++

Copier

public class CheckBoxField : BoundField

Le type CheckBoxField expose les membres suivants.

Constructeurs

	Nom	Description
	CheckBoxField	Initialise une nouvelle instance de la classe CheckBoxField.

Début

Propriétés

	Nom	Description
	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é BoundField.ApplyFormatInEditMode. Cette propriété n'est pas prise en charge par la classe CheckBoxField. (Substitue BoundField.ApplyFormatInEditMode.)
	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é BoundField.ConvertEmptyStringToNull. Cette propriété n'est pas prise en charge par la classe CheckBoxField. (Substitue BoundField.ConvertEmptyStringToNull.)
	DataField	Obtient ou définit le nom du champ de données lié à lier à l'objet CheckBoxField. (Substitue BoundField.DataField.)
	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. (Substitue BoundField.DataFormatString.)
	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é BoundField.HtmlEncode. Cette propriété n'est pas prise en charge par la classe CheckBoxField. (Substitue BoundField.HtmlEncode.)
	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é. (Substitue BoundField.HtmlEncodeFormatString.)
	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. (Substitue BoundField.NullDisplayText.)
	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. (Substitue BoundField.SupportsHtmlEncode.)
	Text	Obtient ou définit la légende à afficher en regard de chaque case à cocher dans un objet CheckBoxField.
	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.)

Début

Méthodes

	Nom	Description
	CloneField	Infrastructure. Crée une copie de l'objet dérivé de DataControlField en cours. (Hérité de DataControlField.)
	CopyProperties	Copie les propriétés de l'objet CheckBoxField actuel vers l'objet DataControlField spécifié. (Substitue BoundField.CopyProperties(DataControlField).)
	CreateField	Crée un objet CheckBoxField vide. (Substitue BoundField.CreateField().)
	Equals(Object)	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	ExtractValuesFromCell	Remplit l'objet System.Collections.IDictionary spécifié avec les valeurs provenant de l'objet DataControlFieldCell spécifié. (Substitue BoundField.ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean).)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	FormatDataValue	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. (Substitue BoundField.GetDesignTimeValue().)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	GetValue	Récupère la valeur du champ lié à l'objet BoundField. (Hérité de BoundField.)
	Initialize	Initialise l'objet BoundField. (Hérité de BoundField.)
	InitializeCell	Initialise l'objet TableCell spécifié à l'état de ligne spécifié. (Hérité de BoundField.)
	InitializeDataCell	Initialise l'objet DataControlFieldCell spécifié à l'état de ligne spécifié. (Substitue BoundField.InitializeDataCell(DataControlFieldCell, DataControlRowState).)
	LoadViewState	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 de l'objet Object actif. (Hérité de Object.)
	OnDataBindField	Lie la valeur d'un champ à une case à cocher dans l'objet CheckBoxField. (Substitue BoundField.OnDataBindField(Object, EventArgs).)
	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. (Substitue BoundField.ValidateSupportsCallback().)

Début

Implémentations d'interface explicite

	Nom	Description
	IDataSourceViewSchemaAccessor.DataSourceViewSchema	Infrastructure. Obtient ou définit le schéma associé à cet objet DataControlField. (Hérité de DataControlField.)
	IStateManager.IsTrackingViewState	Infrastructure. Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField.)
	IStateManager.LoadViewState	Infrastructure. Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données. (Hérité de DataControlField.)
	IStateManager.SaveViewState	Infrastructure. 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	Infrastructure. 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.)

Début

Notes

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.

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

Remarque
É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 la section 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.

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

Remarque

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é de 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.

Exemples

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.

Copier



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

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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

Sécurité des threads

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

Voir aussi