Accueil Library Formation Code Téléchargements Support Evénements Communautés Forums
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ListControl, classe

.NET Framework 4.5

Sert de classe de base abstraite définissant les propriétés, les méthodes et les événements communs à l'ensemble des contrôles de type liste.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
[ControlValuePropertyAttribute("SelectedValue")]
public abstract class ListControl : DataBoundControl, 
	IEditableTextControl, ITextControl
ASP.NET
Copier 
<asp:ListControl />

Le type ListControl expose les membres suivants.

  NomDescription
Méthode publiqueListControlInitialise une nouvelle instance de la classe ListControl.
Début
  NomDescription
Propriété publiqueAccessKeyObtient 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éeAdapterObtient l'adaptateur spécifiques au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAppendDataBoundItemsObtient ou définit une valeur qui indique si les éléments de liste sont effacés avant la liaison des données.
Propriété publiqueAppRelativeTemplateSourceDirectoryObtient ou définit le répertoire virtuel relatif à l'application de l'objet d' Page ou d' UserControl qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueAttributesObtient 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é publiqueAutoPostBackObtient 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.
Propriété publiqueBackColorObtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publiqueBorderColorObtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publiqueBorderStyleObtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBorderWidthObtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueCausesValidationObtient 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.
Propriété protégéeChildControlsCreatedObtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publiqueClientIDObtient l'ID du contrôle pour la balise HTML qui est générée par ASP.NET. (Hérité de Control.)
Propriété publiqueClientIDModeObtient ou définit l'algorithme utilisé pour générer la valeur de la propriété d' ClientID . (Hérité de Control.)
Propriété protégéeClientIDSeparatorObtient une valeur de caractères représentant le caractère de séparation utilisé dans la propriété d' ClientID . (Hérité de Control.)
Propriété protégéeContextObtient l'objet d' HttpContext associé au contrôle serveur pour la requête Web active. (Hérité de Control.)
Propriété publiqueControlsObtient un objet d' ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie d'interface utilisateur. (Hérité de Control.)
Propriété publiqueControlStyleObtient 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é publiqueControlStyleCreatedObtient 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é publiqueCssClassObtient 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é publiqueDataItemContainerObtient une référence au conteneur d'attribution de noms si le conteneur d'attribution de noms implémente IDataItemContainer. (Hérité de Control.)
Propriété publiqueDataKeysContainerObtient une référence au conteneur d'attribution de noms si le conteneur d'attribution de noms implémente IDataKeysControl. (Hérité de Control.)
Propriété publiqueDataMemberObtient 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é publiqueDataSourceObtient 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é publiqueDataSourceIDObtient 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é publiqueDataSourceObjectObtient 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é publiqueDataTextFieldObtient ou définit le champ de la source de données fournissant le texte des éléments de la liste.
Propriété publiqueDataTextFormatStringObtient 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.
Propriété publiqueDataValueFieldObtient ou définit le champ de la source de données fournissant la valeur de chaque élément de la liste.
Propriété protégéeDesignModeObtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publiqueEnabledObtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publiqueEnableThemingObtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publiqueEnableViewStateObtient ou définit une valeur indiquant si le contrôle serveur conserve son état d'affichage, et l'état d'affichage de tous les contrôles enfants qu'il contient, un client demandeur. (Hérité de Control.)
Propriété protégéeEventsObtient une liste des délégués de gestionnaire d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.)
Propriété publiqueFontObtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueForeColorObtient 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é publiqueHasAttributesObtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégéeHasChildViewStateObtient une valeur indiquant si les contrôles enfants actuels du contrôle serveur ont des paramètres enregistrés d'état d'affichage. (Hérité de Control.)
Propriété publiqueHeightObtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueIDObtient ou définit l'identificateur programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégéeIdSeparatorInfrastructure. Obtient le caractère utilisé pour séparer les ID de contrôle. (Hérité de Control.)
Propriété protégéeInitializedObtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl.)
Propriété protégéeIsBoundUsingDataSourceIDObtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl.)
Propriété protégéeIsChildControlStateClearedObtient une valeur indiquant si les contrôles contenus dans le contrôle ont l'état du contrôle. (Hérité de Control.)
Propriété protégéeIsDataBindingAutomaticObtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl.)
Propriété protégéeIsEnabledObtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégéeIsTrackingViewStateObtient 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éeIsUsingModelBindersObtient une valeur qui indique si la liaison de modèle est en cours de utilisation. (Hérité de DataBoundControl.)
Propriété protégéeIsViewStateEnabledObtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété publiqueItemsObtient la collection des éléments figurant dans le contrôle de liste.
Propriété publiqueItemTypeObtient 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.)
Propriété protégéeLoadViewStateByIDObtient une valeur indiquant si le contrôle participe au chargement son état d'affichage par ID au lieu de l'index. (Hérité de Control.)
Propriété publiqueNamingContainerObtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un seul espace de noms pour différencier des contrôles serveur avec la même valeur de propriété d' Control.ID . (Hérité de Control.)
Propriété publiquePageObtient une référence à l'instance d' Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publiqueParentObtient une référence au contrôle du parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.)
Propriété publiqueRenderingCompatibilityObtient une valeur qui spécifie la version d'ASP.NET que le code HTML restitué sera compatible avec. (Hérité de Control.)
Propriété protégéeRequiresDataBindingObtient ou définit une valeur indiquant si la méthode DataBind doit être appelée. (Hérité de BaseDataBoundControl.)
Propriété protégéeSelectArgumentsObtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données d'un contrôle de source de données. (Hérité de DataBoundControl.)
Propriété publiqueSelectedIndexObtient ou définit l'index ordinal le moins élevé des éléments sélectionnés dans la liste.
Propriété publiqueSelectedItemObtient l'élément sélectionné avec l'index le moins élevé dans le contrôle de liste.
Propriété publiqueSelectedValueObtient 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.
Propriété publiqueSelectMethodLe nom de la méthode à appeler pour pouvoir lire des données. (Hérité de DataBoundControl.)
Propriété publiqueSiteObtient des informations sur le conteneur qui héberge le contrôle actuel lorsqu'il est affiché sur une aire de conception. (Hérité de Control.)
Propriété publiqueSkinIDObtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publiqueStyleObtient 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é publiqueSupportsDisabledAttributeObtient 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é publiqueTabIndexObtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeTagKeyObtient la valeur HtmlTextWriterTag du contrôle ListControl. (Substitue WebControl.TagKey.)
Propriété protégéeTagNameObtient 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é publiqueTemplateControlObtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueTemplateSourceDirectoryObtient le répertoire virtuel d' Page ou d' UserControl qui contient le contrôle serveur actuel. (Hérité de Control.)
Propriété publiqueTextObtient ou définit la propriété SelectedValue du contrôle ListControl.
Propriété publiqueToolTipObtient 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é publiqueUniqueIDObtient l'unique, de manière hiérarchique qualifié identificateur du contrôle serveur. (Hérité de Control.)
Propriété publiqueValidateRequestModeObtient ou définit une valeur qui indique si le contrôle vérifie l'entrée de client du navigateur pour les valeurs non sécurisées. (Hérité de Control.)
Propriété publiqueValidationGroupObtient 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.
Propriété protégéeViewStateObtient un dictionnaire des informations d'état qui vous permettent d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur sur plusieurs demandes pour la même page. (Hérité de Control.)
Propriété protégéeViewStateIgnoresCaseObtient une valeur qui indique si l'objet d' StateBag ne respecte pas la casse. (Hérité de Control.)
Propriété publiqueViewStateModeObtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publiqueVisibleObtient ou définit une valeur indiquant si un contrôle serveur est affichée comme interface utilisateur sur la page. (Hérité de Control.)
Propriété publiqueWidthObtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début
  NomDescription
Méthode protégéeAddAttributesToRenderApplique des attributs et des styles HTML à rendre vers l'objet HtmlTextWriter spécifié. (Substitue WebControl.AddAttributesToRender(HtmlTextWriter).)
Méthode protégéeAddedControlAppelé après un contrôle enfant est ajouté à la collection d' Controls de l'objet d' Control . (Hérité de Control.)
Méthode protégéeAddParsedSubObjectInforme le contrôle serveur qu'un élément, XML ou HTML, a été analysé, et ajoute l'élément à l'objet d' ControlCollection du contrôle serveur. (Hérité de Control.)
Méthode publiqueApplyStyleCopie 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 publiqueApplyStyleSheetSkinApplique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control.)
Méthode protégéeBeginRenderTracingDémarre le suivi au moment de le design des données de rendu. (Hérité de Control.)
Méthode protégéeBuildProfileTreeInfrastructure. Rassemble des informations à propos de le contrôle serveur et les fournit à la propriété d' Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.)
Méthode protégéeClearCachedClientIDInfrastructure. Définit la valeur mise en cache d' ClientID à null. (Hérité de Control.)
Méthode protégéeClearChildControlStateSupprime les informations sur l'état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildStateSupprime l'état d'affichage et les informations sur l'état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildViewStateSupprime les informations d'état d'affichage pour des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearEffectiveClientIDModeInfrastructure. Définit la propriété d' ClientIDMode de l'instance de contrôle actuelle et de tous les contrôles enfants à Inherit. (Hérité de Control.)
Méthode publiqueClearSelectionAnnule la sélection de liste et affecte la valeur False à la propriété Selected de tous les éléments.
Méthode protégéeConfirmInitStateDéfinit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl.)
Méthode publiqueCopyBaseAttributesCopie 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éeCreateChildControlsAppelé par l'infrastructure de page ASP.NET. pour informer les contrôles serveur qu'implémentation composition-basée par utilisation de pour créer tous contrôles enfants qu'ils contiennent pendant la vice versa ou du rendu de publication. (Hérité de Control.)
Méthode protégéeCreateControlCollectionCrée un nouvel objet d' ControlCollection pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control.)
Méthode protégéeCreateControlStyleCrée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeCreateDataSourceSelectArgumentsCré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 publiqueDataBind()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éeDataBind(Boolean)Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option de déclencher l'événement d' DataBinding . (Hérité de Control.)
Méthode protégéeDataBindChildrenLie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publiqueDisposePermet à un contrôle serveur pour effectuer la dernière nettoyer avant d'être libérée de la mémoire. (Hérité de Control.)
Méthode protégéeEndRenderTracingTermine le traçage au moment de le design des données de rendu. (Hérité de Control.)
Méthode protégéeEnsureChildControlsDétermine si le contrôle serveur contient des contrôles enfants. Dans le cas contraire, il crée des contrôles enfants. (Hérité de Control.)
Méthode protégéeEnsureDataBoundAppelle 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éeEnsureIDCrée un identificateur pour les contrôles qui n'ont pas un identificateur assigné. (Hérité de Control.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindControl(String)Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec le paramètre spécifié d' id . (Hérité de Control.)
Méthode protégéeFindControl(String, Int32)Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec id spécifié et un entier, spécifié dans le paramètre d' pathOffset , ce qui simplifie la recherche. Vous ne devez pas substituer cette version de la méthode d' FindControl . (Hérité de Control.)
Méthode publiqueFocusDéfinit le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégéeGetDataRé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éeGetDataSourceRé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éeGetDesignModeStateInfrastructure. Obtient des données au moment de le design pour un contrôle. (Hérité de Control.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetRouteUrl(Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, Object)Obtient l'URL qui correspond à un jeu de paramètres de routage et d'un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres de routage et d'un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetUniqueIDRelativeToRetourne la partie préfixée de la propriété d' UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publiqueHasControlsDétermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégéeHasEventsRetourne une valeur indiquant si les événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégéeIsLiteralContentInfrastructure. Détermine si le contrôle serveur contient uniquement le contenu littéral. (Hérité de Control.)
Méthode protégéeLoadControlStateRestaure les informations sur l'état du contrôle d'une demande de page précédente qui a été signalée par la méthode d' SaveControlState . (Hérité de Control.)
Méthode protégéeLoadViewStateCharge l'état d'affichage enregistré précédemment du contrôle DetailsView. (Substitue DataBoundControl.LoadViewState(Object).)
Méthode protégéeMapPathSecureRécupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, tables. (Hérité de Control.)
Méthode protégéeMarkAsDataBoundDé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éeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueMergeStyleCopie 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éeOnBubbleEventDétermine si l'événement du contrôle serveur est passé en haut de la hiérarchie de contrôle de l'interface utilisateur de la page. (Hérité de Control.)
Méthode protégéeOnCreatingModelDataSourceDéclenche l'événement CreatingModelDataSource. (Hérité de DataBoundControl.)
Méthode protégéeOnDataBindingInfrastructure. Déclenche l'événement DataBinding. (Substitue Control.OnDataBinding(EventArgs).)
Méthode protégéeOnDataBoundDéclenche l'événement DataBound. (Hérité de BaseDataBoundControl.)
Méthode protégéeOnDataPropertyChangedRelie 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éeOnDataSourceViewChangedDéclenche l'événement DataSourceViewChanged. (Hérité de DataBoundControl.)
Méthode protégéeOnInitGère l'événement Init. (Hérité de BaseDataBoundControl.)
Méthode protégéeOnLoadGère l'événement Control.Load. (Hérité de DataBoundControl.)
Méthode protégéeOnPagePreLoadDé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éeOnPreRenderDéclenche l'événement PreRender. (Substitue BaseDataBoundControl.OnPreRender(EventArgs).)
Méthode protégéeOnSelectedIndexChangedDéclenche l'événement SelectedIndexChanged. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégéeOnTextChangedDéclenche l'événement TextChanged.
Méthode protégéeOnUnloadDéclenche l'événement d' Unload . (Hérité de Control.)
Méthode protégéeOpenFileObtient Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégéePerformDataBindingInfrastructure. Lie la source de données spécifiée au contrôle dérivé de la classe ListControl. (Substitue DataBoundControl.PerformDataBinding(IEnumerable).)
Méthode protégéePerformSelectRécupère les données de la source de données associée. (Substitue DataBoundControl.PerformSelect().)
Méthode protégéeRaiseBubbleEventAssigne toutes les sources d'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégéeRemovedControlAppelé après un contrôle enfant est supprimé de la collection d' Controls de l'objet d' Control . (Hérité de Control.)
Méthode protégéeRenderGénère le rendu du contrôle via le writer HTML spécifié. (Hérité de WebControl.)
Méthode publiqueRenderBeginTagGé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éeRenderChildrenRenvoie le contenu des enfants d'un contrôle serveur à un objet fourni d' HtmlTextWriter , qui écrit le contenu à afficher sur le client. (Hérité de Control.)
Méthode protégéeRenderContentsGénère le rendu des éléments dans le contrôle ListControl. (Substitue WebControl.RenderContents(HtmlTextWriter).)
Méthode publiqueRenderControl(HtmlTextWriter)Renvoie le contenu de contrôle serveur à un objet fourni d' HtmlTextWriter et stocke les informations de traçage sur le contrôle s'il est activé. (Hérité de Control.)
Méthode protégéeRenderControl(HtmlTextWriter, ControlAdapter)Renvoie le contenu de contrôle serveur à un objet fourni d' HtmlTextWriter à l'aide d'un objet fourni d' ControlAdapter . (Hérité de Control.)
Méthode publiqueRenderEndTagGé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éeResolveAdapterObtient l'adaptateur de contrôle responsable de l'affichage du contrôle spécifié. (Hérité de Control.)
Méthode publiqueResolveClientUrlObtient une URL qui peut être utilisé par le navigateur. (Hérité de Control.)
Méthode publiqueResolveUrlConvertit une URL dans un utilisable sur le client demandeur. (Hérité de Control.)
Méthode protégéeSaveControlStateEnregistre toutes les modifications d'état de contrôle serveur qui se sont produites étant donné que le temps que la page a été publiée sur le serveur. (Hérité de Control.)
Méthode protégéeSaveViewStateEnregistre l'état d'affichage actuel du contrôle dérivé de ListControl et les éléments qu'il contient. (Substitue DataBoundControl.SaveViewState().)
Méthode protégéeSetDesignModeStateDéfinit les données au moment de le design pour un contrôle. (Hérité de Control.)
Méthode protégéeSetPostDataSelectionInfrastructure. Définit la propriété Selected d'un contrôle ListItem après la publication d'une page.
Méthode publiqueSetRenderMethodDelegateInfrastructure. Affecte un délégué de gestionnaire d'événements pour afficher le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object)Définit les données de traçage pour le suivi au moment de le design des données de rendu, à l'aide de la clé de données de trace et la valeur des données de trace. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object, Object)Définit les données de traçage pour le suivi au moment de le design des données de rendu, à l'aide de l'objet d'un suivi, la clé de données de traçage, et la valeur des données de trace. (Hérité de Control.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégéeTrackViewStateMarque 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. (Substitue DataBoundControl.TrackViewState().)
Méthode protégéeValidateDataSourceVé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éeVerifyMultiSelectInfrastructure. Détermine si le contrôle de liste prend en charge le mode de sélection multiple.
Début
  NomDescription
Événement publicCallingDataMethodsSe produit lorsque les méthodes de données sont appelées. (Hérité de DataBoundControl.)
Événement publicCreatingModelDataSourceSe produit lorsque l'objet d' ModelDataSource est créé. (Hérité de DataBoundControl.)
Événement publicDataBindingSe produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement publicDataBoundSe produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl.)
Événement publicDisposedSe produit lorsqu'un contrôle serveur est récupéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle serveur où une page ASP.NET. est demandée. (Hérité de Control.)
Événement publicInitSe produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control.)
Événement publicLoadSe produit lorsque le contrôle serveur est chargé dans l'objet d' Page . (Hérité de Control.)
Événement publicPreRenderSe produit une fois que l'objet d' Control soit chargé mais avant le rendu. (Hérité de Control.)
Événement publicSelectedIndexChangedSe produit lorsque la sélection du contrôle de liste change entre des publications sur le serveur.
Événement publicTextChangedSe produit lorsque les propriétés Text et SelectedValue sont modifiées.
Événement publicUnloadSe produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début
  NomDescription
Méthode d'extension publiqueEnablePersistedSelectionRend 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 publiqueFindDataSourceControlRetourne 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 publiqueFindFieldTemplateRetourne 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 publiqueFindMetaTableRetourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Début
  NomDescription
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.GetAttributeInfrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.SetAttributeAffecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface explicitePropriété privéeIControlBuilderAccessor.ControlBuilderPour obtenir une description de ce membre, consultez l' IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.GetDesignModeStatePour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetDesignModeStatePour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetOwnerControlInfrastructure. Pour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIControlDesignerAccessor.UserDataPour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.DataBindingsPour obtenir une description de ce membre, consultez l' IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.HasDataBindingsPour obtenir une description de ce membre, consultez l' IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.ExpressionsPour obtenir une description de ce membre, consultez l' IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.HasExpressionsPour obtenir une description de ce membre, consultez l' IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez l' IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Début

Il n'est pas possible de créer une instance de la classe abstraite ListControl directement. Cette classe est, en revanche, héritée par d'autres classes, telles que les classes CheckBoxList, DropDownList, ListBox et RadioButtonList, pour fournir une fonctionnalité de base commune.

Les propriétés de la classe ListControl vous permettent de spécifier la source de données pour remplir le contrôle de liste. Utilisez la propriété DataSource pour spécifier la source de données à associer au contrôle de liste. Si la source de données contient plusieurs tables, utilisez la propriété DataMember pour spécifier la table à utiliser. Vous pouvez lier plusieurs champs de la source de données aux propriétés ListItem.Text et ListItem.Value des éléments d'un contrôle de liste en définissant respectivement les propriétés DataTextField et DataValueField. Le texte affiché pour chaque élément du contrôle de liste peut être mis en forme en définissant la propriété DataTextFormatString.

Tous les éléments affichés dans le contrôle de liste sont stockés dans la collection Items. Utilisez la propriété SelectedIndex pour spécifier ou déterminer par programme l'index d'un élément sélectionné dans le contrôle de liste. Il est possible d'accéder aux propriétés de l'élément sélectionné à l'aide de la propriété SelectedItem.

La classe ListControl fournit l'événement SelectedIndexChanged qui est déclenché lorsque la sélection est modifiée dans le contrôle de liste entre des publications sur le serveur. Cela vous permet de fournir un gestionnaire personnalisé de cet événement. Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

La classe ListControl implémente l'interface IEditableTextControl afin que les contrôles de type liste dérivés puissent être utilisés avec le mode modèles d'autres contrôles.

L'exemple de code suivant illustre comment sélectionner des éléments dans un contrôle ListBox. Si l'élément est trouvé dans la zone de texte, il est sélectionné et un message indiquant le nom de l'élément sélectionné apparaît. S'il n'est pas trouvé, aucun élément n'est sélectionné et un message indiquant que l'élément n'a pas été trouvé apparaît.

Note de sécuritéNote de sécurité

Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Script Exploits Overview.

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

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }

      }

   </script>

</head>

<body>

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

      <h3> ListControl SelectedValue Example </h3>

      <asp:ListBox ID="List"
           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:ListBox>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </form>

</body>
</html>

.NET Framework

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

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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)

Ajouts de la communauté

AJOUTER
© 2013 Microsoft. Tous droits réservés.
|
Commentaires sur le site
© 2013 Microsoft. Tous droits réservés.