CheckBoxField Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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::BoundFieldpublic class CheckBoxField : System.Web.UI.WebControls.BoundFieldtype CheckBoxField = class
inherit BoundFieldPublic 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é |
| 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 |
| 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 |
| 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) |