CheckBoxList 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.
Crée un groupe de cases à cocher à sélection multiple qui peut être créé dynamiquement en liant le contrôle à une source de données.
public ref class CheckBoxList : System::Web::UI::WebControls::ListControl, System::Web::UI::INamingContainer, System::Web::UI::IPostBackDataHandler, System::Web::UI::WebControls::IRepeatInfoUserpublic class CheckBoxList : System.Web.UI.WebControls.ListControl, System.Web.UI.INamingContainer, System.Web.UI.IPostBackDataHandler, System.Web.UI.WebControls.IRepeatInfoUsertype CheckBoxList = class
inherit ListControl
interface IRepeatInfoUser
interface INamingContainer
interface IPostBackDataHandlerPublic Class CheckBoxList
Inherits ListControl
Implements INamingContainer, IPostBackDataHandler, IRepeatInfoUser- Héritage
- Héritage
- Implémente
Exemples
L’exemple de code suivant montre comment créer un CheckBoxList contrôle sur une page Web.
Note
L’exemple de code suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET modèle de code de page Web Forms.
<%@ 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>
<%@ Page Language="VB" 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">
Sub Check_Clicked(sender as Object, e As EventArgs)
Message.Text = "Selected Item(s):<br /><br />"
' Iterate through the Items collection of the CheckBoxList
' control and display the selected items.
Dim i As Integer
For i=0 To checkboxlist1.Items.Count - 1
If checkboxlist1.Items(i).Selected Then
Message.Text &= checkboxlist1.Items(i).Text & "<br />"
End If
Next
End Sub
</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>
Remarques
Contenu de cet article :
- Introduction
- Spécification de la disposition de liste
- Spécification d’éléments de liste
- Accessibilité
- Syntaxe déclarative
Présentation
Le CheckBoxList contrôle fournit un groupe de cases à cocher à sélection multiple qui peut être généré dynamiquement avec la liaison de données. Il contient une Items collection avec des membres correspondant à des éléments individuels dans la liste. Pour déterminer quels éléments sont vérifiés, effectuez une itération dans la collection et testez la Selected propriété de chaque élément de la liste.
Note
Vous pouvez également utiliser plusieurs CheckBox contrôles. Le CheckBoxList contrôle est plus facile à créer un ensemble de cases à cocher à l’aide de la liaison de données, tandis que le contrôle individuel CheckBox vous permet de mieux contrôler la disposition.
Spécification de la disposition de liste
Vous pouvez spécifier la façon dont la liste est affichée à l’aide des propriétés et RepeatDirection des RepeatLayout propriétés. Pour plus d’informations sur les options de disposition, consultez l’énumération RepeatLayout .
Par défaut, RepeatDirection est définie sur RepeatDirection.Vertical. La définition de cette propriété pour RepeatDirection.Horizontal afficher la liste horizontalement. Certains RepeatLayout paramètres 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 souhaitez afficher dans le CheckBoxList contrôle, placez un ListItem élément pour chaque entrée entre les balises d’ouverture et de fermeture du CheckBoxList contrôle.
Le contrôle prend également en charge la CheckBoxList liaison de données. Pour lier le contrôle à une source de données, créez d’abord une source de données, telle que l’un DataSourceControl des objets, qui contient les éléments à afficher dans le contrôle. Ensuite, utilisez la DataBind méthode pour lier la source de données au CheckBoxList contrôle. Utilisez les propriétés et DataValueField les DataTextField propriétés pour spécifier le champ de la source de données à lier aux propriétés et Value aux Text propriétés de chaque élément de liste du contrôle, respectivement. Le CheckBoxList contrôle affiche désormais les informations de la source de données.
Pour déterminer les éléments sélectionnés dans le CheckBoxList contrôle, effectuez une itération dans la Items collection et testez la Selected propriété de chaque élément de la collection.
Avertissement
Ce contrôle peut être utilisé pour afficher l’entrée utilisateur, qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou tout autre code avant de l’afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier l’entrée utilisateur avant d’afficher le texte d’entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de demande d’entrée pour bloquer le script et le code HTML dans l’entrée utilisateur. Pour plus d’informations, consultez Sécurisation des contrôles standard, Comment : protéger contre les attaques de script dans une application web en appliquant l’encodage HTML à des chaînes et en validant l’entrée utilisateur dans ASP.NET pages web.
Accessibilité
Pour plus d’informations sur la configuration de ce contrôle afin qu’il génère des marques conformes aux normes d’accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et ASP.NET Contrôles et accessibilité.
Syntaxe déclarative
<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>
Constructeurs
| Nom | Description |
|---|---|
| CheckBoxList() |
Initialise une nouvelle instance de la classe CheckBoxList. |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl) |
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AppendDataBoundItems |
Obtient ou définit une valeur qui indique si les éléments de liste sont effacés avant la liaison de données. (Hérité de ListControl) |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| Attributes |
Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle. (Hérité de WebControl) |
| 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) |
| BackColor |
Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web. (Hérité de WebControl) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| BorderColor |
Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl) |
| BorderStyle |
Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl) |
| BorderWidth |
Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl) |
| CausesValidation |
Obtient ou définit une valeur indiquant si la validation est effectuée lorsqu’un contrôle dérivé de la ListControl classe est cliqué. (Hérité de ListControl) |
| CellPadding |
Obtient ou définit la distance (en pixels) entre la bordure et le contenu de la cellule. |
| CellSpacing |
Obtient ou définit la distance (en pixels) entre les cellules. |
| ChildControlsCreated |
Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control) |
| ClientIDMode |
Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control) |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient un ControlCollection objet 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) |
| ControlStyle |
Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ControlStyleCreated |
Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| CssClass |
Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
| DataItemContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control) |
| DataMember |
Obtient ou définit la table spécifique dans la DataSource liaison au contrôle. (Hérité de ListControl) |
| DataSource |
Obtient ou définit la source de données qui remplit les éléments du contrôle de liste. (Hérité de ListControl) |
| DataSourceID |
Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données. (Hérité de DataBoundControl) |
| 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) |
| DataTextField |
Obtient ou définit le champ de la source de données qui fournit le contenu texte des éléments de liste. (Hérité de ListControl) |
| DataTextFormatString |
Obtient ou définit la chaîne de mise en forme utilisée pour contrôler l’affichage des données liées au contrôle de liste. (Hérité de ListControl) |
| DataValueField |
Obtient ou définit le champ de la source de données qui fournit la valeur de chaque élément de liste. (Hérité de ListControl) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| Enabled |
Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl) |
| EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de WebControl) |
| EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
| Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
| 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) |
| HasAttributes |
Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl) |
| HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control) |
| HasFooter |
Obtient une valeur indiquant si le CheckBoxList contrôle contient une section de pied de page. |
| HasHeader |
Obtient une valeur indiquant si le CheckBoxList contrôle contient une section de titre. |
| HasSeparators |
Obtient une valeur indiquant si le CheckBoxList contrôle contient un séparateur entre les éléments de la liste. |
| Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control) |
| Initialized |
Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Obtient une valeur indiquant si la DataSourceID propriété est définie. (Hérité de BaseDataBoundControl) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control) |
| IsDataBindingAutomatic |
Obtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl) |
| IsEnabled |
Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl) |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control) |
| IsUsingModelBinders |
Obtient une valeur qui indique si la liaison de modèle est en cours d’utilisation. (Hérité de DataBoundControl) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control) |
| Items |
Obtient la collection d’éléments dans le contrôle de liste. (Hérité de ListControl) |
| ItemType |
Obtient ou définit le nom du type d’élément de données pour la liaison de données fortement typée. (Hérité de DataBoundControl) |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control) |
| Page |
Obtient une référence à l’instance Page qui contient le contrôle serveur. (Hérité de Control) |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control) |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| RenderWhenDataEmpty |
Obtient ou définit une valeur qui indique si le contrôle est rendu lorsque la source de données n’a pas de données ou que le contrôle n’est pas lié aux données. |
| RepeatColumns |
Obtient ou définit le nombre de colonnes à afficher dans le CheckBoxList contrôle. |
| RepeatDirection |
Obtient ou définit une valeur qui indique si le contrôle s’affiche verticalement ou horizontalement. |
| RepeatedItemCount |
Obtient le nombre d’éléments de liste dans le CheckBoxList contrôle. |
| RepeatLayout |
Obtient ou définit une valeur qui spécifie si la liste sera rendue à l’aide d’un élément, d’un |
| RequiresDataBinding |
Obtient ou définit une valeur indiquant si la DataBind() méthode doit être appelée. (Hérité de BaseDataBoundControl) |
| SelectArguments |
Obtient un DataSourceSelectArguments objet 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) |
| SelectedIndex |
Obtient ou définit l’index ordinal le plus bas des éléments sélectionnés dans la liste. (Hérité de ListControl) |
| SelectedItem |
Obtient l’élément sélectionné avec l’index le plus bas dans le contrôle de liste. (Hérité de ListControl) |
| SelectedValue |
Obtient la valeur de l’élément sélectionné dans le contrôle de liste ou sélectionne l’élément dans le contrôle de liste qui contient la valeur spécifiée. (Hérité de ListControl) |
| SelectMethod |
Nom de la méthode à appeler pour lire les données. (Hérité de DataBoundControl) |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl) |
| Style |
Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web. (Hérité de WebControl) |
| SupportsDisabledAttribute |
Obtient une valeur qui indique si le contrôle doit définir l’attribut |
| TabIndex |
Obtient ou définit l’index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
| TagKey |
Obtient la HtmlTextWriterTag valeur du ListControl contrôle. (Hérité de ListControl) |
| TagName |
Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
| TemplateSourceDirectory |
Obtient le répertoire virtuel du PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| Text |
Obtient ou définit la SelectedValue propriété du ListControl contrôle. (Hérité de ListControl) |
| TextAlign |
Obtient ou définit l’alignement du texte pour les cases à cocher dans le groupe. |
| ToolTip |
Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl) |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control) |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control) |
| ValidationGroup |
Obtient ou définit le groupe de contrôles pour lesquels le contrôle dérivé de la classe provoque la ListControl validation lorsqu’elle retourne au serveur. (Hérité de ListControl) |
| 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 sur plusieurs requêtes pour la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse. (Hérité de Control) |
| ViewStateMode |
Obtient ou définit le mode d’état d’affichage de ce contrôle. (Hérité de Control) |
| Visible |
Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control) |
| Width |
Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl) |
Méthodes
| Nom | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Applique des attributs et des styles HTML pour le rendu à l’objet spécifié HtmlTextWriter . (Hérité de ListControl) |
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control) |
| ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Définit la valeur mise en ClientID cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildViewState() |
Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearEffectiveClientIDMode() |
Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control) |
| ClearSelection() |
Efface la sélection de la liste et définit la Selected propriété de tous les éléments sur false. (Hérité de ListControl) |
| ConfirmInitState() |
Définit l’état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
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 les développeurs de contrôles. (Hérité de WebControl) |
| CreateChildControls() |
Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control) |
| CreateControlCollection() |
Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control) |
| CreateControlStyle() |
Crée un objet de style utilisé en interne par le CheckBoxList contrôle pour implémenter toutes les propriétés associées au style. |
| CreateDataSourceSelectArguments() |
Crée un objet par défaut DataSourceSelectArguments utilisé par le contrôle lié aux données si aucun argument n’est spécifié. (Hérité de DataBoundControl) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de BaseDataBoundControl) |
| 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) |
| DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
| Dispose() |
Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi au moment du design des données de rendu. (Hérité de Control) |
| EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control) |
| EnsureDataBound() |
Appelle la DataBind() méthode si la DataSourceID propriété est définie et que le contrôle lié aux données est marqué pour exiger une liaison. (Hérité de BaseDataBoundControl) |
| EnsureID() |
Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindControl(String, Int32) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec l’ID et le décalage de chemin spécifiés. La FindControl(String, Int32) méthode retourne toujours l’objet CheckBoxList . |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur un contrôle. (Hérité de Control) |
| GetData() |
Récupère un DataSourceView objet que le contrôle lié aux données utilise pour effectuer des opérations de données. (Hérité de DataBoundControl) |
| GetDataSource() |
Récupère l’interface IDataSource avec laquelle le contrôle lié aux données est associé, le cas échéant. (Hérité de DataBoundControl) |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetItemStyle(ListItemType, Int32) |
Récupère le style du type d’élément spécifié à l’index spécifié dans le contrôle de liste. |
| GetRouteUrl(Object) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control) |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
| HasEvents() |
Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control) |
| LoadPostData(String, NameValueCollection) |
Traite les données publiées pour le CheckBoxList contrôle. |
| LoadViewState(Object) |
Charge l’état d’affichage précédemment enregistré du DetailsView contrôle. (Hérité de ListControl) |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MarkAsDataBound() |
Définit l’état du contrôle dans l’état d’affichage comme étant lié avec succès aux données. (Hérité de DataBoundControl) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control) |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Déclenche l’événement CreatingModelDataSource. (Hérité de DataBoundControl) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de ListControl) |
| OnDataBound(EventArgs) |
Déclenche l’événement DataBound. (Hérité de BaseDataBoundControl) |
| OnDataPropertyChanged() |
Rebind le contrôle lié aux données à ses données après la modification de l’une des propriétés d’identification de la source de données de base. (Hérité de DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Déclenche l’événement DataSourceViewChanged. (Hérité de DataBoundControl) |
| OnInit(EventArgs) |
Déclenche l’événement Init. |
| OnInit(EventArgs) |
Déclenche l’événement Init. (Hérité de Control) |
| OnInit(EventArgs) |
Gère l’événement Init . (Hérité de BaseDataBoundControl) |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnLoad(EventArgs) |
Gère l’événement Load . (Hérité de DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Définit l’état initialisé du contrôle lié aux données avant le chargement du contrôle. (Hérité de DataBoundControl) |
| OnPreRender(EventArgs) |
Configure le contrôle avant le CheckBoxList rendu sur le client. |
| OnSelectedIndexChanged(EventArgs) |
Déclenche l’événement SelectedIndexChanged. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement. (Hérité de ListControl) |
| OnTextChanged(EventArgs) |
Déclenche l’événement TextChanged. (Hérité de ListControl) |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control) |
| PerformDataBinding(IEnumerable) |
Lie la source de données spécifiée au contrôle dérivé de la ListControl classe. (Hérité de ListControl) |
| PerformSelect() |
Récupère les données de la source de données associée. (Hérité de ListControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaisePostDataChangedEvent() |
Avertit l’application ASP.NET que l’état du CheckBoxList contrôle a changé. |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Affiche le CheckBoxList client. |
| RenderBeginTag(HtmlTextWriter) |
Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderChildren(HtmlTextWriter) |
Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
Affiche les éléments dans le ListControl contrôle. (Hérité de ListControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control) |
| RenderEndTag(HtmlTextWriter) |
Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter) |
Affiche un élément de liste dans le CheckBoxList contrôle. |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control) |
| SaveControlState() |
Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre l’état d’affichage actuel du ListControl contrôle -derived et les éléments qu’il contient. (Hérité de ListControl) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetPostDataSelection(Int32) |
Définit la Selected propriété d’un ListItem contrôle après la publication d’une page. (Hérité de ListControl) |
| SetRenderMethodDelegate(RenderMethod) |
Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TrackViewState() |
Marque le point de départ pour commencer le suivi et l’enregistrement des modifications de l’état d’affichage dans un ListControl contrôle -derived. (Hérité de ListControl) |
| ValidateDataSource(Object) |
Vérifie que l’objet auquel un contrôle lié aux données est lié est un contrôle qu’il peut utiliser. (Hérité de DataBoundControl) |
| VerifyMultiSelect() |
Détermine si le contrôle de liste prend en charge le mode de sélection multiple. (Hérité de ListControl) |
Événements
| Nom | Description |
|---|---|
| CallingDataMethods |
Se produit lorsque les méthodes de données sont appelées. (Hérité de DataBoundControl) |
| CreatingModelDataSource |
Se produit lorsque l’objet ModelDataSource est créé. (Hérité de DataBoundControl) |
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| DataBound |
Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl) |
| Disposed |
Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control) |
| Load |
Se produit lorsque le contrôle serveur est chargé dans l’objet Page . (Hérité de Control) |
| PreRender |
Se produit après le chargement de l’objet Control , mais avant le rendu. (Hérité de Control) |
| SelectedIndexChanged |
Se produit lorsque la sélection du contrôle de liste change entre les publications sur le serveur. (Hérité de ListControl) |
| TextChanged |
Se produit lorsque les Text propriétés changent SelectedValue . (Hérité de ListControl) |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
| IPostBackDataHandler.LoadPostData(String, NameValueCollection) |
Traite les données publiées pour le CheckBoxList contrôle. |
| IPostBackDataHandler.RaisePostDataChangedEvent() |
Déclenché lors de la publication de données pour un contrôle a changé. |
| IRepeatInfoUser.GetItemStyle(ListItemType, Int32) |
Pour obtenir une description de ce membre, consultez GetItemStyle(ListItemType, Int32). |
| IRepeatInfoUser.HasFooter |
Obtient une valeur qui indique si le contrôle de liste contient une section de pied de page. |
| IRepeatInfoUser.HasHeader |
Obtient une valeur qui indique si le contrôle de liste contient une section de titre. |
| IRepeatInfoUser.HasSeparators |
Obtient une valeur qui indique si le contrôle de liste contient un séparateur entre les éléments de la liste. |
| IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter) |
Pour obtenir une description de ce membre, consultez RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter). |
| IRepeatInfoUser.RepeatedItemCount |
Obtient le nombre d’éléments dans le contrôle de liste. |
Méthodes d’extension
| Nom | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type, Object) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnablePersistedSelection(BaseDataBoundControl) |
Obsolète.
Permet de conserver la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination. |
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l’objet métatable pour le contrôle de données contenant. |
| GetDefaultValues(INamingContainer) |
Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. |
| GetMetaTable(INamingContainer) |
Obtient les métadonnées de table pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable) |
Définit les métadonnées de table pour le contrôle de données spécifié. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Détermine si les métadonnées de table sont disponibles. |
S’applique à
Voir aussi
- ListControl
- CheckBox
- Contrôles serveur web CheckBox et CheckBoxList
- Sécurisation des contrôles standard
- Guide pratique pour protéger contre les attaques de script dans une application web en appliquant l’encodage HTML à des chaînes
- Présentation de la validation de l’entrée utilisateur dans ASP.NET pages web
