Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
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

CheckBoxList, classe

.NET Framework 4

Crée un groupe de cases à cocher à sélection multiple qui peut être généré de manière dynamique en liant le contrôle à une source de données.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.ListControl
            System.Web.UI.WebControls.CheckBoxList

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public class CheckBoxList : ListControl, 
	IRepeatInfoUser, INamingContainer, IPostBackDataHandler
ASP.NET
Copier 
<asp:CheckBoxList />

Le type CheckBoxList expose les membres suivants.

  Nom Description
Méthode publique CheckBoxList Initialise une nouvelle instance de la classe CheckBoxList.
Début
  Nom Description
Propriété publique AccessKey Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl.)
Propriété protégée Adapter Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publique AppendDataBoundItems Obtient ou définit une valeur qui indique si les éléments de liste sont effacés avant la liaison des données. (Hérité de ListControl.)
Propriété publique AppRelativeTemplateSourceDirectory Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control.)
Propriété publique Attributes Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl.)
Propriété publique AutoPostBack Obtient ou définit une valeur indiquant si une publication sur le serveur se produit automatiquement lorsque l'utilisateur modifie la sélection de la liste. (Hérité de ListControl.)
Propriété publique BackColor Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BindingContainer Infrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publique BorderColor Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publique BorderStyle Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BorderWidth Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique CausesValidation Obtient ou définit une valeur indiquant si une validation est effectuée suite à un clic sur le contrôle dérivé de la classe ListControl. (Hérité de ListControl.)
Propriété publique CellPadding Obtient ou définit la distance (en pixels) entre la bordure et le contenu de la cellule.
Propriété publique CellSpacing Obtient ou définit la distance (en pixels) entre les cellules.
Propriété protégée ChildControlsCreated Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publique ClientID Obtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.)
Propriété publique ClientIDMode Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.)
Propriété protégée ClientIDSeparator Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control.)
Propriété protégée Context Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publique Controls Obtient un objet ControlCollection qui représente les contrôles enfants d'un contrôle serveur spécifié dans la hiérarchie de l'interface utilisateur. (Hérité de Control.)
Propriété publique ControlStyle Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publique ControlStyleCreated Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publique CssClass Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl.)
Propriété publique DataItemContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publique DataKeysContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété publique DataMember Obtient ou définit le nom de la liste des données auxquelles le contrôle lié aux données se lie, dans les cas où la source de données contient plusieurs listes distinctes d'éléments de données. (Hérité de DataBoundControl.)
Propriété publique DataSource Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de BaseDataBoundControl.)
Propriété publique DataSourceID Obtient ou définit l'ID du contrôle duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de DataBoundControl.)
Propriété publique DataSourceObject Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet. (Hérité de DataBoundControl.)
Propriété publique DataTextField Obtient ou définit le champ de la source de données fournissant le texte des éléments de la liste. (Hérité de ListControl.)
Propriété publique DataTextFormatString Obtient ou définit la chaîne de mise en forme permettant de contrôler l'affichage des données liées au contrôle de liste. (Hérité de ListControl.)
Propriété publique DataValueField Obtient ou définit le champ de la source de données fournissant la valeur de chaque élément de la liste. (Hérité de ListControl.)
Propriété protégée DesignMode Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publique Enabled Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publique EnableTheming Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publique EnableViewState Obtient ou définit une valeur indiquant si le contrôle serveur rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande. (Hérité de Control.)
Propriété protégée Events Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.)
Propriété publique Font Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publique ForeColor Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique HasAttributes Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégée HasChildViewState Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control.)
Propriété protégée HasFooter Obtient une valeur indiquant si le contrôle CheckBoxList contient une section de pied de page.
Propriété protégée HasHeader Obtient une valeur indiquant si le contrôle CheckBoxList contient une section d'en-tête.
Propriété protégée HasSeparators Obtient une valeur indiquant si le contrôle CheckBoxList contient un séparateur entre les éléments de la liste.
Propriété publique Height Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique ID Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégée IdSeparator Infrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégée Initialized Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl.)
Propriété protégée IsBoundUsingDataSourceID Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl.)
Propriété protégée IsChildControlStateCleared Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.)
Propriété protégée IsEnabled Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégée IsTrackingViewState Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
Propriété protégée IsViewStateEnabled Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété publique Items Obtient la collection des éléments figurant dans le contrôle de liste. (Hérité de ListControl.)
Propriété protégée LoadViewStateByID Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control.)
Propriété publique NamingContainer Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété Control.ID possède la même valeur. (Hérité de Control.)
Propriété publique Page Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publique Parent Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.)
Propriété publique RenderingCompatibility Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété publique RepeatColumns Obtient ou définit le nombre de colonnes à afficher dans le contrôle CheckBoxList.
Propriété publique RepeatDirection Obtient ou définit une valeur indiquant si le contrôle est affiché verticalement ou horizontalement.
Propriété protégée RepeatedItemCount Obtient le nombre d'éléments de liste figurant dans le contrôle CheckBoxList.
Propriété publique RepeatLayout Obtient ou définit une valeur qui spécifie si la liste sera restituée à l'aide d'un élément table, d'un élément ul, d'un élément ol ou d'un élément span.
Propriété protégée RequiresDataBinding Obtient ou définit une valeur indiquant si la méthode DataBind doit être appelée. (Hérité de BaseDataBoundControl.)
Propriété protégée SelectArguments Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données à partir d'un contrôle de source de données. (Hérité de DataBoundControl.)
Propriété publique SelectedIndex Obtient ou définit l'index ordinal le moins élevé des éléments sélectionnés dans la liste. (Hérité de ListControl.)
Propriété publique SelectedItem Obtient l'élément sélectionné avec l'index le moins élevé dans le contrôle de liste. (Hérité de ListControl.)
Propriété publique SelectedValue Obtient la valeur de l'élément sélectionné dans le contrôle de liste ou sélectionne, dans ce contrôle, l'élément qui contient la valeur spécifiée. (Hérité de ListControl.)
Propriété publique Site Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control.)
Propriété publique SkinID Obtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publique Style Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl.)
Propriété publique SupportsDisabledAttribute Obtient une valeur qui indique si le contrôle doit affecter à l'attribut disabled de l'élément HTML rendu la valeur "disabled" lorsque la propriété IsEnabled du contrôle a la valeur false. (Hérité de BaseDataBoundControl.)
Propriété publique TabIndex Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégée TagKey Obtient la valeur HtmlTextWriterTag du contrôle ListControl. (Hérité de ListControl.)
Propriété protégée TagName Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publique TemplateControl Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publique TemplateSourceDirectory Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publique Text Obtient ou définit la propriété SelectedValue du contrôle ListControl. (Hérité de ListControl.)
Propriété publique TextAlign Obtient ou définit l'alignement du texte des cases à cocher du groupe.
Propriété publique ToolTip Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl.)
Propriété publique UniqueID Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
Propriété publique ValidationGroup Obtient ou définit le groupe de contrôles pour lequel le contrôle dérivé de la classe ListControl provoque la validation lors de la publication sur le serveur. (Hérité de ListControl.)
Propriété protégée ViewState Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control.)
Propriété protégée ViewStateIgnoresCase Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
Propriété publique ViewStateMode Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publique Visible Obtient ou définit une valeur qui indique si un contrôle serveur est rendu sous la forme d'une interface utilisateur sur la page. (Hérité de Control.)
Propriété publique Width Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début
  Nom Description
Méthode protégée AddAttributesToRender Applique des attributs et des styles HTML à rendre vers l'objet HtmlTextWriter spécifié. (Hérité de ListControl.)
Méthode protégée AddedControl Appelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégée AddParsedSubObject Avertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à l'objet ControlCollection du contrôle serveur. (Hérité de Control.)
Méthode publique ApplyStyle Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode publique ApplyStyleSheetSkin Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control.)
Méthode protégée BuildProfileTree Infrastructure. Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.)
Méthode protégée ClearCachedClientID Infrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégée ClearChildControlState Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée ClearChildState Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée ClearChildViewState Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée ClearEffectiveClientIDMode Infrastructure. Affecte la valeur Inherit à la propriété ClientIDMode de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control.)
Méthode publique ClearSelection Annule la sélection de liste et affecte la valeur False à la propriété Selected de tous les éléments. (Hérité de ListControl.)
Méthode protégée ConfirmInitState Définit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl.)
Méthode publique CopyBaseAttributes Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée CreateChildControls Appelé par l'infrastructure de page ASP.NET pour avertir les contrôles serveur qui utilisent une implémentation basée sur la composition qu'ils doivent créer tous les contrôles enfants qu'ils contiennent en préparation de la publication ou du rendu. (Hérité de Control.)
Méthode protégée CreateControlCollection Crée un nouvel objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control.)
Méthode protégée CreateControlStyle Infrastructure. Crée un objet de style qui est utilisé de manière interne par le contrôle CheckBoxList pour implémenter toutes les propriétés associées au style. (Substitue WebControl.CreateControlStyle().)
Méthode protégée CreateDataSourceSelectArguments Crée un objet DataSourceSelectArguments par défaut utilisé par le contrôle lié aux données si aucun argument n'est spécifié. (Hérité de DataBoundControl.)
Méthode publique DataBind() Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de BaseDataBoundControl.)
Méthode protégée DataBind(Boolean) Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control.)
Méthode protégée DataBindChildren Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publique Dispose Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control.)
Méthode protégée EnsureChildControls Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control.)
Méthode protégée EnsureDataBound Appelle la méthode DataBind si la propriété DataSourceID est définie et que le contrôle lié aux données est marqué pour demander à être lié. (Hérité de BaseDataBoundControl.)
Méthode protégée EnsureID Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée 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.)
Méthode publique FindControl(String) Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control.)
Méthode protégée FindControl(String, Int32) Infrastructure. Recherche un contrôle serveur possédant l'ID et l'offset du chemin d'accès spécifiés dans le conteneur d'attribution de noms en cours. La méthode FindControl retourne toujours l'objet CheckBoxList. (Substitue Control.FindControl(String, Int32).)
Méthode publique Focus Affecte le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégée GetData Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données. (Hérité de DataBoundControl.)
Méthode protégée GetDataSource Récupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant. (Hérité de DataBoundControl.)
Méthode protégée GetDesignModeState Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode protégée GetItemStyle Récupère le style du type d'élément spécifié, à l'index spécifié dans le contrôle de liste.
Méthode publique GetRouteUrl(Object) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique GetRouteUrl(RouteValueDictionary) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique GetRouteUrl(String, Object) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
Méthode publique GetRouteUrl(String, RouteValueDictionary) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique GetUniqueIDRelativeTo Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publique HasControls Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégée HasEvents Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégée IsLiteralContent Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégée LoadControlState Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState. (Hérité de Control.)
Méthode protégée LoadPostData Traite les données publiées pour le contrôle CheckBoxList.
Méthode protégée LoadViewState Charge l'état d'affichage enregistré précédemment du contrôle DetailsView. (Hérité de ListControl.)
Méthode protégée MapPathSecure Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control.)
Méthode protégée MarkAsDataBound Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données. (Hérité de DataBoundControl.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique MergeStyle Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée OnBubbleEvent Détermine si l'événement pour le contrôle serveur est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Hérité de Control.)
Méthode protégée OnDataBinding Infrastructure. Déclenche l'événement DataBinding. (Hérité de ListControl.)
Méthode protégée OnDataBound Déclenche l'événement DataBound. (Hérité de BaseDataBoundControl.)
Méthode protégée OnDataPropertyChanged Relie le contrôle lié aux données à ses données après la modification d'une des propriétés de l'identification de la source de données de base. (Hérité de DataBoundControl.)
Méthode protégée OnDataSourceViewChanged Déclenche l'événement DataSourceViewChanged. (Hérité de DataBoundControl.)
Méthode protégée OnInit Gère l'événement Init. (Hérité de BaseDataBoundControl.)
Méthode protégée OnLoad Gère l'événement Control.Load. (Hérité de DataBoundControl.)
Méthode protégée OnPagePreLoad Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. (Hérité de DataBoundControl.)
Méthode protégée OnPreRender Configure le contrôle CheckBoxList avant l'affichage sur le client. (Substitue ListControl.OnPreRender(EventArgs).)
Méthode protégée OnSelectedIndexChanged Déclenche l'événement SelectedIndexChanged. Cela vous permet de fournir un gestionnaire personnalisé à l'événement. (Hérité de ListControl.)
Méthode protégée OnTextChanged Déclenche l'événement TextChanged. (Hérité de ListControl.)
Méthode protégée OnUnload Déclenche l'événement Unload. (Hérité de Control.)
Méthode protégée OpenFile Obtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégée PerformDataBinding Infrastructure. Lie la source de données spécifiée au contrôle dérivé de la classe ListControl. (Hérité de ListControl.)
Méthode protégée PerformSelect Récupère les données de la source de données associée. (Hérité de ListControl.)
Méthode protégée RaiseBubbleEvent Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégée RaisePostDataChangedEvent Indique à l'application ASP.NET le changement d'état du contrôle CheckBoxList.
Méthode protégée RemovedControl Appelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégée Render Affiche le CheckBoxList sur le client. (Substitue WebControl.Render(HtmlTextWriter).)
Méthode publique RenderBeginTag Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée RenderChildren Renvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
Méthode protégée RenderContents Génère le rendu des éléments dans le contrôle ListControl. (Hérité de ListControl.)
Méthode publique RenderControl(HtmlTextWriter) Renvoie le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du contrôle si le traçage est activé. (Hérité de Control.)
Méthode protégée RenderControl(HtmlTextWriter, ControlAdapter) Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control.)
Méthode publique RenderEndTag Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée RenderItem Génère le rendu d'un élément de liste dans le contrôle CheckBoxList.
Méthode protégée ResolveAdapter Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publique ResolveClientUrl Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publique ResolveUrl Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégée SaveControlState Enregistre les modifications éventuellement apportées à l'état du contrôle serveur depuis la publication de la page sur le serveur. (Hérité de Control.)
Méthode protégée SaveViewState Enregistre l'état d'affichage actuel du contrôle dérivé de ListControl et les éléments qu'il contient. (Hérité de ListControl.)
Méthode protégée SetDesignModeState Définit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode protégée SetPostDataSelection Infrastructure. Définit la propriété Selected d'un contrôle ListItem après la publication d'une page. (Hérité de ListControl.)
Méthode publique SetRenderMethodDelegate Infrastructure. Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégée TrackViewState Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées à un contrôle dérivé de ListControl. (Hérité de ListControl.)
Méthode protégée ValidateDataSource Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner. (Hérité de DataBoundControl.)
Méthode protégée VerifyMultiSelect Infrastructure. Détermine si le contrôle de liste prend en charge le mode de sélection multiple. (Hérité de ListControl.)
Début
  Nom Description
Événement public DataBinding Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement public DataBound Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl.)
Événement public Disposed Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control.)
Événement public Init Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control.)
Événement public Load Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement public PreRender Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
Événement public SelectedIndexChanged Se produit lorsque la sélection du contrôle de liste change entre des publications sur le serveur. (Hérité de ListControl.)
Événement public TextChanged Se produit lorsque les propriétés Text et SelectedValue sont modifiées. (Hérité de ListControl.)
Événement public Unload Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début
  Nom Description
Méthode d'extension publique EnableDynamicData(Type) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique EnableDynamicData(Type, Object) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique EnableDynamicData(Type, IDictionary<String, Object>) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique EnablePersistedSelection Rend la sélection persistante dans les contrôles de données qui prennent en charge la sélection et la pagination. (Défini par DynamicDataExtensions.)
Méthode d'extension publique FindDataSourceControl Retourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique FindFieldTemplate Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique FindMetaTable Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Méthode d'extension publique GetDefaultValues Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique GetMetaTable Obtient les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique SetMetaTable(MetaTable) Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique SetMetaTable(MetaTable, IDictionary<String, Object>) Surchargé. Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique SetMetaTable(MetaTable, Object) Surchargé. Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique TryGetMetaTable Détermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée IAttributeAccessor.GetAttribute Infrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface explicite Méthode privée IAttributeAccessor.SetAttribute Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface explicite Propriété privée IControlBuilderAccessor.ControlBuilder Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.GetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetOwnerControl Infrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IControlDesignerAccessor.UserData Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.DataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.HasDataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.Expressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.HasExpressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IParserAccessor.AddParsedSubObject Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IPostBackDataHandler.LoadPostData Infrastructure. Traite des données publiées pour le contrôle CheckBoxList.
Implémentation d'interface explicite Méthode privée IPostBackDataHandler.RaisePostDataChangedEvent Infrastructure. Est déclenché lorsque les données publiées pour un contrôle ont été modifiées.
Implémentation d'interface explicite Méthode privée IRepeatInfoUser.GetItemStyle Infrastructure. Pour obtenir une description de ce membre, consultez IRepeatInfoUser.GetItemStyle.
Implémentation d'interface explicite Propriété privée IRepeatInfoUser.HasFooter Infrastructure. Obtient une valeur qui indique si le contrôle de liste contient une section de pied de page.
Implémentation d'interface explicite Propriété privée IRepeatInfoUser.HasHeader Infrastructure. Obtient une valeur qui indique si le contrôle de liste contient une section d'en-tête.
Implémentation d'interface explicite Propriété privée IRepeatInfoUser.HasSeparators Infrastructure. Obtient une valeur qui indique si le contrôle de liste contient un séparateur entre les éléments de la liste.
Implémentation d'interface explicite Méthode privée IRepeatInfoUser.RenderItem Infrastructure. Pour obtenir une description de ce membre, consultez RenderItem.
Implémentation d'interface explicite Propriété privée IRepeatInfoUser.RepeatedItemCount Infrastructure. Obtient le nombre d'éléments figurant dans le contrôle de liste.
Début

Dans cette rubrique :

Introduction

Le contrôle CheckBoxList fournit un groupe de cases à cocher à sélection multiple qui peut être généré de manière dynamique avec la liaison de données. Il contient une collection Items avec des membres correspondant à des éléments individuels dans la liste. Pour déterminer quels éléments sont activés, itérez au sein de la collection et testez la propriété Selected de chaque élément de la liste.

Remarque Remarque

Vous pouvez également utiliser plusieurs contrôles CheckBox. Le contrôle CheckBoxList permet de créer plus facilement un groupe de cases à cocher à l'aide de la liaison de données, tandis que le contrôle CheckBox individuel offre un meilleur contrôle de la mise en page.

Spécification de la disposition de liste

Vous pouvez spécifier la manière dont la liste est affichée en utilisant les propriétés RepeatLayout et RepeatDirection. Pour plus d'informations sur les options de disposition, consultez l'énumération RepeatLayout.

RepeatDirection a la valeur par défaut RepeatDirection.Vertical. L'affectation de la valeur RepeatDirection.Horizontal à cette propriété rend la liste horizontalement. Certains paramètres RepeatLayout n'autorisent pas la disposition horizontale. Pour plus d'informations, consultez l'énumération RepeatLayout.

Spécification d'éléments de liste

Pour spécifier les éléments que vous voulez voir apparaître dans le contrôle CheckBoxList, insérez un élément ListItem pour chaque entrée entre les balises d'ouverture et de fermeture du contrôle CheckBoxList.

Le contrôle CheckBoxList prend également en charge la liaison de données. Pour lier le contrôle à une source de données, commencez par créer une source de données, par exemple l'un des objets DataSourceControl, qui contient les éléments à afficher dans le contrôle. Ensuite, utilisez la méthode DataBind pour lier la source de données au contrôle CheckBoxList. Utilisez les propriétés DataTextField et DataValueField pour spécifier les champs de la source de données à lier respectivement aux propriétés Text et Value de chaque élément de liste du contrôle. Le contrôle CheckBoxList affichera désormais les informations à partir de la source de données.

Pour déterminer les éléments sélectionnés dans le contrôle CheckBoxList, itérez au sein de la collection Items et testez la propriété Selected de chaque élément de la collection.

Remarque Attention Attention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client nuisible. Vérifiez toutes les informations envoyées par un client pour un script exécutable, des instructions SQL ou un autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier les entrées d'utilisateur avant d'afficher le texte d'entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de la demande d'entrée pour bloquer les scripts et le code HTML dans les entrées d'utilisateur. Pour plus d'informations, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant l'encodage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

Accessibilité

Pour plus d'informations sur la configuration de ce contrôle afin qu'il génère des balises conforment aux standards d'accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et Contrôles et accessibilité ASP.NET.

Syntaxe déclarative

Copier 
<asp:CheckBoxList
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    RepeatColumns="integer"
    RepeatDirection="Horizontal|Vertical"
    RepeatLayout="Table|Flow|OrderedList|UnorderedList"
    runat="server"
    SelectedIndex="integer"
    SelectedValue="string"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    TextAlign="Left|Right"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:CheckBoxList>

Un projet de site Web Visual Studio contenant du code source est disponible pour accompagner cette rubrique : Download.

L'exemple de code suivant illustre la création d'un contrôle CheckBoxList sur une page Web.

Remarque Remarque

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code des Web Forms, consultez Modèle de code des pages Web ASP.NET.

C#
VB
Copier 


<%@ Page Language="C#" AutoEventWireup="True" %>

<!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> CheckBoxList Example </title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {

         Message.Text = "Selected Item(s):<br /><br />";

         // Iterate through the Items collection of the CheckBoxList 
         // control and display the selected items.
         for (int i=0; i<checkboxlist1.Items.Count; i++)
         {

            if (checkboxlist1.Items[i].Selected)
            {

               Message.Text += checkboxlist1.Items[i].Text + "<br />";

            }

         }

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> CheckBoxList Example </h3>

      Select items from the CheckBoxList.

      <br /><br />

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:CheckBoxList>

      <br /><br />

      <asp:label id="Message" runat="server" AssociatedControlID="checkboxlist1"/>

   </form>

</body>

</html>

.NET Framework

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

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.
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.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ