CheckBoxField Classe

Définition

Représente un champ booléen affiché sous forme de case à cocher dans un contrôle lié aux données.Represents a Boolean field that is displayed as a check box in a data-bound control.

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.The following code example demonstrates how to use a CheckBoxField object in a 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>


<%@ 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 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.The CheckBoxField class is used by data-bound controls (such as GridView and DetailsView) to display the value of a Boolean data field in a check box. L' CheckBoxField objet est affiché différemment en fonction du contrôle lié aux données dans lequel il est utilisé.The CheckBoxField object is displayed differently depending on the data-bound control in which it is used. Par exemple, le GridView contrôle affiche un CheckBoxField objet sous la forme d’une colonne, tandis que le DetailsView contrôle l’affiche sous forme de ligne.For example, the GridView control displays a CheckBoxField object as a column, while the DetailsView control displays it as a row.

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.A check box is disabled (read-only) until the data-bound control displays a record that contains the check box in edit mode. Pour plus d’informations sur la façon de placer un enregistrement en mode édition, consultez la documentation relative au contrôle parent qui contient l' CheckBoxField objet.For more information on how to put a record into edit mode, see the documentation for the parent control that contains the CheckBoxField object.

Pour spécifier le champ à afficher dans un CheckBoxField objet, définissez la DataField propriété avec le nom du champ.To specify the field to display in a CheckBoxField object, set the DataField property with the field's name.

Notes

Étant donné qu’une case à cocher peut afficher uniquement 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 qui peut être analysée par Parse .Because a check box can display only a selected or an unselected state, a CheckBoxField object can be bound only to a field with a Boolean data type or a string that can be parsed by Parse.

Vous pouvez afficher une légende en regard de chaque case à cocher en définissant la Text propriété.You can display a caption next to each check box by setting the Text property. Un CheckBoxField objet est masqué dans un contrôle lié aux données lorsque la Visible propriété a la valeur false .A CheckBoxField object is hidden in a data-bound control when the Visible property is set to false. Pour empêcher la modification de la valeur d’un champ en mode édition, affectez ReadOnly à la propriété la valeur true .To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. Dans les contrôles liés aux données qui prennent en charge l’insertion d’enregistrements (tels que le DetailsView contrôle), vous pouvez masquer un CheckBoxField objet en mode insertion en affectant à la propriété la valeur InsertVisible false .In data-bound controls that support inserting records (such as the DetailsView control), you can hide a CheckBoxField object in insert mode by setting the InsertVisible property to false.

Vous pouvez personnaliser les sections d’en-tête et de pied de page d’un CheckBoxField objet.You can customize the header and footer sections of a CheckBoxField object. Pour afficher une légende dans les sections d’en-tête ou de pied de page, définissez les HeaderText FooterText Propriétés ou, respectivement.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. 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é.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. La section d’en-tête peut être masquée dans l' CheckBoxField objet en affectant à la propriété la valeur ShowHeader false .The header section can be hidden in the CheckBoxField object by setting the ShowHeader property to false.

Notes

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement l’intégralité de la section d’en-tête du contrôle.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété d’un champ lié individuel.These data-bound controls do not support the ShowHeader property for an individual bound field. Pour afficher ou masquer l’intégralité de la section d’en-tête d’un contrôle lié aux données (si disponible), utilisez la propriété du contrôle ShowHeader .To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

Vous pouvez également personnaliser l’apparence de l' CheckBoxField objet (couleur de police, couleur d’arrière-plan, etc.) en définissant les propriétés de style pour les différentes parties du champ.You also can customize the appearance of the CheckBoxField object (font color, background color, and so on) by setting the style properties for the different parts of the field. Le tableau suivant répertorie les différentes propriétés de style.The following table lists the different style properties.

Propriété styleStyle property DescriptionDescription
ControlStyle Paramètres de style pour les contrôles serveur Web enfants de l' CheckBoxField objet.The style settings for the child Web server controls of the CheckBoxField object.
FooterStyle Paramètres de style de la section de pied de page de l' CheckBoxField objet.The style settings for the footer section of the CheckBoxField object.
HeaderStyle Paramètres de style de la section d’en-tête de l' CheckBoxField objet.The style settings for the header section of the CheckBoxField object.
ItemStyle Paramètres de style pour les éléments de données de l' CheckBoxField objet.The style settings for the data items in the CheckBoxField object.

Constructeurs

CheckBoxField()

Initialise une nouvelle instance de la classe CheckBoxField.Initializes a new instance of the CheckBoxField class.

Propriétés

AccessibleHeaderText

Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Hérité de DataControlField)
ApplyFormatInEditMode

Substitue la propriété ApplyFormatInEditMode.Overrides the ApplyFormatInEditMode property. Cette propriété n'est pas prise en charge par la classe CheckBoxField.This property is not supported by the CheckBoxField class.

Control

Obtient une référence au contrôle de données auquel l'objet DataControlField est associé.Gets a reference to the data control that the DataControlField object is associated with.

(Hérité de DataControlField)
ControlStyle

Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(Hérité de DataControlField)
ConvertEmptyStringToNull

Substitue la propriété ConvertEmptyStringToNull.Overrides the ConvertEmptyStringToNull property. Cette propriété n'est pas prise en charge par la classe CheckBoxField.This property is not supported by the CheckBoxField class.

DataField

Obtient ou définit le nom du champ de données lié à lier à l'objet CheckBoxField.Gets or sets the name of the data field to bind to the CheckBoxField object.

DataFormatString

Obtient ou définit la chaîne qui spécifie le format d'affichage de la valeur du champ.Gets or sets the string that specifies the display format for the value of the field. Cette propriété n'est pas prise en charge par la classe CheckBoxField.This property is not supported by the CheckBoxField class.

DesignMode

Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Hérité de DataControlField)
FooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.Gets or sets the style of the footer of the data control field.

(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.Gets or sets the text that is displayed in the footer item of a data control field.

(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.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Hérité de DataControlField)
HeaderStyle

Obtient ou définit le style de l'en-tête du champ de contrôle de données.Gets or sets the style of the header of the data control field.

(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.Gets or sets the text that is displayed in the header of a data control.

(Hérité de BoundField)
HtmlEncode

Substitue la propriété HtmlEncode.Overrides the HtmlEncode property. Cette propriété n'est pas prise en charge par la classe CheckBoxField.This property is not supported by the CheckBoxField class.

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é.Gets or sets a value that indicates whether the formatted text should be HTML encoded before it is displayed.

InsertVisible

Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Hérité de DataControlField)
IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Hérité de DataControlField)
ItemStyle

Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données.Gets the style of any text-based content displayed by a data control field.

(Hérité de DataControlField)
NullDisplayText

Obtient ou définit le texte affiché pour un champ lorsque la valeur du champ est null.Gets or sets the text displayed for a field when the field's value is null. Cette propriété n'est pas prise en charge par la classe CheckBoxField.This property is not supported by the CheckBoxField class.

ReadOnly

Obtient ou définit une valeur indiquant si la valeur du champ peut être modifiée en mode édition.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

(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é.Gets or sets a value indicating whether the header item of a data control field is rendered.

(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.Gets or sets a sort expression that is used by a data source control to sort data.

(Hérité de DataControlField)
SupportsHtmlEncode

Obtient une valeur Boolean indiquant si le contrôle prend en charge l'encodage HTML.Gets a Boolean value indicating whether the control supports HTML encoding.

Text

Obtient ou définit la légende à afficher en regard de chaque case à cocher dans un objet CheckBoxField.Gets or sets the caption to display next to each check box in a CheckBoxField object.

ValidateRequestMode

Obtient ou définit une valeur qui détermine si le contrôle valide l'entrée cliente ou non.Gets or sets a value that determines whether the control validates client input or not.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Hérité de DataControlField)
Visible

Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué.Gets or sets a value indicating whether a data control field is rendered.

(Hérité de DataControlField)

Méthodes

CloneField()

Crée une copie de l'objet dérivé de DataControlField en cours.Creates a duplicate copy of the current DataControlField-derived object.

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

Copie les propriétés de l'objet CheckBoxField actuel vers l'objet DataControlField spécifié.Copies the properties of the current CheckBoxField object to the specified DataControlField object.

CreateField()

Crée un objet CheckBoxField vide.Creates an empty CheckBoxField object.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(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é.Fills the specified IDictionary object with the values from the specified DataControlFieldCell object.

FormatDataValue(Object, Boolean)

Met en forme la valeur de champ spécifiée pour une cellule dans l'objet BoundField.Formats the specified field value for a cell in the BoundField object.

(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.Retrieves the value used for the field's value when rendering the CheckBoxField object in a designer.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Récupère la valeur du champ lié à l'objet BoundField.Retrieves the value of the field bound to the BoundField object.

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

Initialise l'objet BoundField.Initializes the BoundField object.

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

Initialise l'objet TableCell spécifié à l'état de ligne spécifié.Initializes the specified TableCell object to the specified row state.

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

Initialise l'objet DataControlFieldCell spécifié à l'état de ligne spécifié.Initializes the specified DataControlFieldCell object to the specified row state.

LoadViewState(Object)

Restaure les informations d'état d'affichage précédemment enregistrées pour ce champ.Restores the previously stored view-state information for this field.

(Hérité de BoundField)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

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

Lie la valeur d'un champ à une case à cocher dans l'objet CheckBoxField.Binds the value of a field to a check box in the CheckBoxField object.

OnFieldChanged()

Déclenche l’événement FieldChanged.Raises the FieldChanged event.

(Hérité de DataControlField)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Hérité de DataControlField)
ToString()

Retourne une chaîne qui représente cet objet DataControlField.Returns a string that represents this DataControlField object.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Hérité de DataControlField)
ValidateSupportsCallback()

Détermine si les contrôles contenus dans un objet CheckBoxField prennent en charge les rappels.Determines whether the controls contained in a CheckBoxField object support callbacks.

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtient ou définit le schéma associé à cet objet DataControlField.Gets or sets the schema associated with this DataControlField object.

(Hérité de DataControlField)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(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.Restores the data control field's previously saved view state.

(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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Hérité de DataControlField)

S’applique à

Voir aussi