Exporter (0) Imprimer
Développer tout
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

Repeater, classe

Contrôle de liste lié aux données permettant une présentation personnalisée, grâce à l'application d'un modèle spécifié à chacun des éléments figurant dans la liste.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

public class Repeater : Control, INamingContainer
<asp:Repeater />

Le type Repeater expose les membres suivants.

  NomDescription
Méthode publiqueRepeaterInitialise une nouvelle instance de la classe Repeater.
Début

  NomDescription
Propriété protégéeAdapterObtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAlternatingItemTemplateObtient ou définit l'objet implémentant System.Web.UI.ITemplate qui définit l'affichage des éléments de remplacement dans le contrôle.
Propriété publiqueAppRelativeTemplateSourceDirectoryObtient 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é publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété protégéeChildControlsCreatedObtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publiqueClientIDObtient l'ID de contrôle pour le balisage HTML généré 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é ClientID. (Hérité de Control.)
Propriété protégéeClientIDSeparatorObtient 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éeContextObtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publiqueControlsObtient un System.Web.UI.ControlCollection qui contient les contrôles enfants du contrôle Repeater. (Substitue Control.Controls.)
Propriété publiqueDataItemContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publiqueDataKeysContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété publiqueDataMemberObtient ou définit un tableau spécifique dans DataSource à lier au contrôle.
Propriété publiqueDataSourceObtient ou définit la source de données fournissant les données assurant le remplissage de la liste.
Propriété publiqueDataSourceIDObtient ou définit la propriété ID du contrôle de source de données que le contrôle Repeater doit utiliser pour récupérer sa source de données.
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é publiqueEnableThemingObtient ou définit une valeur indiquant si les thèmes sont appliqués à ce contrôle. (Substitue Control.EnableTheming.)
Propriété publiqueEnableViewStateObtient 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éeEventsObtient 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é publiqueFooterTemplateObtient ou définit l'interface System.Web.UI.ITemplate déterminant l'affichage de la section du pied de page du contrôle Repeater.
Propriété protégéeHasChildViewStateObtient 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é publiqueHeaderTemplateObtient ou définit l'interface System.Web.UI.ITemplate déterminant l'affichage de la section de l'en-tête du contrôle Repeater.
Propriété publiqueIDObtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégéeIdSeparatorInfrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégéeInitializedInfrastructure. Retourne une valeur indiquant si le contrôle a été initialisé.
Propriété protégéeIsBoundUsingDataSourceIDInfrastructure. Obtient une valeur indiquant si la propriété DataSourceID est définie.
Propriété protégéeIsChildControlStateClearedObtient 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éeIsDataBindingAutomaticObtient une valeur qui indique si la liaison de données est automatique.
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éeIsViewStateEnabledObtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété publiqueItemsObtient une collection d'objets RepeaterItem dans le contrôle Repeater.
Propriété publiqueItemTemplateObtient ou définit l'interface System.Web.UI.ITemplate déterminant l'affichage des éléments dans le contrôle Repeater.
Propriété publiqueItemTypeNom du type de modèle pour la liaison de données fortement typées.
Propriété protégéeLoadViewStateByIDObtient 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é publiqueNamingContainerObtient 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é publiquePageObtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publiqueParentObtient 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é publiqueRenderingCompatibilityObtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété protégéeRequiresDataBindingObtient ou définit une valeur qui indique si le contrôle Repeater doit être lié à sa source de données spécifiée.
Propriété protégéeSelectArgumentsInfrastructure. Obtient un objet DataSourceSelectArguments que le contrôle Repeater utilise lors de la récupération de données d'un contrôle de source de données.
Propriété publiqueSelectMethodNom de la méthode à appeler pour pouvoir lire les données.
Propriété publiqueSeparatorTemplateObtient ou définit l'interface System.Web.UI.ITemplate qui définit l'affichage du séparateur entre les éléments.
Propriété publiqueSiteObtient 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é publiqueSkinIDObtient ou définit l'apparence à appliquer au contrôle. (Hérité de Control.)
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 du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publiqueUniqueIDObtient l'identificateur unique qualifié sur le plan hiérarchique 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 cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control.)
Propriété protégéeViewStateObtient 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éeViewStateIgnoresCaseObtient une valeur qui indique si l'objet StateBag respecte 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 qui indique si un contrôle serveur est rendu sous la forme d'une interface utilisateur sur la page. (Hérité de Control.)
Début

  NomDescription
Méthode protégéeAddedControlAppelé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éeAddParsedSubObjectAvertit 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 publiqueApplyStyleSheetSkinApplique 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éeBeginRenderTracingCommence le traçage au moment du design des données de rendu. (Hérité de Control.)
Méthode protégéeBuildProfileTreeInfrastructure. 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éeClearCachedClientIDInfrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégéeClearChildControlStateSupprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildStateSupprime 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éeClearChildViewStateSupprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearEffectiveClientIDModeInfrastructure. 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 protégéeCreateChildControlsInfrastructure. 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. (Substitue Control.CreateChildControls().)
Méthode protégéeCreateControlCollectionCré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éeCreateControlHierarchyInfrastructure. Crée une hiérarchie des contrôles, avec ou sans la source de données spécifiée.
Méthode protégéeCreateDataSourceSelectArgumentsInfrastructure. Retourne la valeur Empty.
Méthode protégéeCreateItemInfrastructure. Crée un objet RepeaterItem avec le type d'élément et l'emplacement spécifiés dans le contrôle Repeater.
Méthode publiqueDataBind()Infrastructure. Lie le contrôle Repeater et tous ses contrôles enfants à la source de données spécifiée. (Substitue Control.DataBind().)
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 pour déclencher l'événement 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 d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control.)
Méthode protégéeEndRenderTracingMet fin au traçage au moment du 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. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control.)
Méthode protégéeEnsureDataBoundVérifie que le contrôle Repeater requiert la liaison de données et qu'un contrôle de source de données valide est spécifié avant d'appeler la méthode DataBind.
Méthode protégéeEnsureIDCrée un identificateur pour les contrôles auxquels aucun identificateur n'est 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 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éeFindControl(String, Int32)Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control.)
Méthode publiqueFocusAffecte le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégéeGetDataInfrastructure. Retourne une interface IEnumerable de la source de données.
Méthode protégéeGetDesignModeStateInfrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (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 d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(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 publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetUniqueIDRelativeToRetourne la partie préfixée de la propriété 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 des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégéeInitializeItemInfrastructure. Remplit de manière itérative RepeaterItem spécifié avec une sous-hiérarchie de contrôles enfants.
Méthode protégéeIsLiteralContentInfrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégéeLoadControlStateRestaure 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éeLoadViewStateRestaure les informations d'état d'affichage à partir d'une demande de page antérieure enregistrée à l'aide de la méthode SaveViewState. (Substitue Control.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, correspond. (Hérité de Control.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnBubbleEventInfrastructure. Déclenche l'événement ItemCommand si le paramètre EventArgs constitue une instance de RepeaterCommandEventArgs. (Substitue Control.OnBubbleEvent(Object, EventArgs).)
Méthode protégéeOnCreatingModelDataSourceDéclenche l'événement CreatingModelDataSource.
Méthode protégéeOnDataBindingInfrastructure. Déclenche l'événement DataBinding. (Substitue Control.OnDataBinding(EventArgs).)
Méthode protégéeOnDataPropertyChangedInfrastructure. Détermine si la liaison de données est requise.
Méthode protégéeOnDataSourceViewChangedAffecte la valeur true à la propriété RequiresDataBinding.
Méthode protégéeOnInitDéclenche l'événement Init. (Substitue Control.OnInit(EventArgs).)
Méthode protégéeOnItemCommandDéclenche l'événement ItemCommand.
Méthode protégéeOnItemCreatedDéclenche l'événement ItemCreated.
Méthode protégéeOnItemDataBoundDéclenche l'événement ItemDataBound.
Méthode protégéeOnLoadDéclenche l'événement Load et exécute une autre initialisation. (Substitue Control.OnLoad(EventArgs).)
Méthode protégéeOnPreRenderDéclenche l'événement PreRender. (Substitue Control.OnPreRender(EventArgs).)
Méthode protégéeOnUnloadDéclenche l'événement Unload. (Hérité de Control.)
Méthode protégéeOpenFileObtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégéeRaiseBubbleEventAssigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégéeRemovedControlAppelé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éeRenderEnvoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
Méthode protégéeRenderChildrenRenvoie 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 publiqueRenderControl(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éeRenderControl(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 protégéeResolveAdapterObtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publiqueResolveClientUrlObtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publiqueResolveUrlConvertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégéeSaveControlStateEnregistre 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éeSaveViewStateEnregistre les modifications éventuellement apportées à l'état d'affichage depuis la publication de la page sur le serveur. (Substitue Control.SaveViewState().)
Méthode protégéeSetDesignModeStateDéfinit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publiqueSetRenderMethodDelegateInfrastructure. 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 publiqueSetTraceData(Object, Object)Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object, Object)Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode protégéeTrackViewStateProvoque le suivi des modifications de l'état d'affichage pour le contrôle afin qu'elles puissent être stockées dans l'objet StateBag du contrôle. (Substitue Control.TrackViewState().)
Début

  NomDescription
Événement publicCallingDataMethodsSe produit lorsque les méthodes de données sont appelées.
Événement publicCreatingModelDataSourceSe produit lorsque l'objet ModelDataSource est créé.
Événement publicDataBindingSe produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement publicDisposedSe 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 publicInitSe 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 publicItemCommandSe produit lors d'un clic sur le bouton d'un contrôle Repeater.
Événement publicItemCreatedSe produit lors de la création d'un élément dans le contrôle Repeater.
Événement publicItemDataBoundSe produit après qu'un élément présent dans le contrôle Repeater a été lié aux données, mais avant qu'il soit rendu sur la page.
Événement publicLoadSe produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement publicPreRenderSe produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
É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 publiqueEnableDynamicData(Type)Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publiqueEnableDynamicData(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 publiqueEnableDynamicData(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 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.)
Méthode d'extension publiqueGetDefaultValuesObtient la collection des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueGetMetaTableObtient les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueSetMetaTable(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 publiqueSetMetaTable(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 publiqueSetMetaTable(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 publiqueTryGetMetaTableDétermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.)
Début

  NomDescription
Implémentation d'interface explicitePropriété privéeIControlBuilderAccessor.ControlBuilderPour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.GetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetOwnerControlInfrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIControlDesignerAccessor.UserDataPour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.DataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.HasDataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.ExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.HasExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Début

Dans cette rubrique :

Introduction

Le contrôle Repeater correspond à une liste modélisée liée aux données. Comme il n'intègre pas de dispositions ni de styles intégrés, vous devez explicitement déclarer toutes les balises de présentation, de mise en forme et de style au sein des modèles du contrôle.

Le contrôle Repeater vous permet de fractionner des balises d'un modèle à un autre. Pour créer un tableau à l'aide de modèles, insérez une balise de début de tableau <table>) dans la propriété HeaderTemplate, une balise de ligne de tableau simple (<tr>) dans la propriété ItemTemplate et une balise de fin de tableau (</table>) dans la propriété FooterTemplate.

Le contrôle Repeater ne possède pas de fonctionnalité de sélection ni de prise en charge de l'édition. Vous pouvez utiliser l'événement ItemCommand pour traiter les événements de contrôle qui sont déclenchés des modèles au contrôle.

Mise en gardeAttention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client nuisible. Recherchez dans toutes les informations envoyées par un client un script exécutable, des instructions SQL ou d'autre code avant de les afficher dans votre application. ASP.NET fournit une fonctionnalité de validation de demande d'entrée pour bloquer les scripts et le HTML dans les entrées d'utilisateur (user input). Des contrôles serveur de validation sont également fournis pour valider les entrées d'utilisateur (user input). Pour plus d'informations, consultez Syntaxe des contrôles serveur de validation.

Liaison de données

Le contrôle Repeater fournit deux propriétés pour prendre en charge la liaison de données. Pour lier des données à une collection qui implémente l'interface System.Collections.IEnumerable (tel que System.Data.DataView, System.Collections.ArrayList ou un tableau), ou l'interface IListSource, utilisez la propriété DataSource pour spécifier la source de données. Lorsque vous définissez la propriété DataSource, vous devez écrire manuellement le code permettant d'effectuer la liaison de données. Pour lier automatiquement le contrôle Repeater à une source de données représentée par un contrôle de source de données, attribuez à la propriété DataSourceID la valeur ID du contrôle de source de données à utiliser. Lorsque vous définissez la propriété DataSourceID, le contrôle Repeater se lie automatiquement au contrôle de source de données spécifié lors de la première demande. Par conséquent, vous n'avez pas besoin d'appeler explicitement la méthode DataBind, sauf si vous avez modifié les propriétés liées aux données du contrôle Repeater.

Un contrôle Repeater lie son ItemTemplate et son AlternatingItemTemplate soit avec le modèle de données déclaré et référencé par sa propriété DataSource, soit avec le contrôle de source de données spécifié par sa propriété DataSourceID. Les propriétés HeaderTemplate, FooterTemplate et SeparatorTemplate ne sont pas liées aux données.

Si la source de données du contrôle Repeater est définie, mais qu'aucune donnée n'est retournée, le contrôle restitue alors HeaderTemplate et FooterTemplate sans élément. Si la source de données est null, le contrôle Repeater n'est pas restitué.

Modèles

Chaque contrôle Repeater doit définir ItemTemplate au minimum. D'autres modèles optionnels décrits dans le tableau suivant permettent toutefois de personnaliser la présentation de la liste.

Nom du modèle

Description

ItemTemplate

Définit le contenu et la disposition des éléments dans la liste. Ce modèle est obligatoire.

AlternatingItemTemplate

S'il est défini, le contenu et la disposition d'éléments de remplacement (index impair commençant par zéro) sont alors déterminés. S'il n'est pas défini, ItemTemplate est utilisé.

SeparatorTemplate

S'il est défini, la restitution s'effectue alors entre les éléments (et éléments de remplacement). S'il n'est pas défini, aucun séparateur n'est alors restitué.

HeaderTemplate

S'il est défini, le contenu et la disposition de l'en-tête de liste sont alors déterminés. S'il n'est pas défini, aucun en-tête n'est alors restitué.

FooterTemplate

S'il est défini, le contenu et la disposition du pied de page de liste sont alors déterminés. S'il n'est pas défini, aucun pied de page n'est alors restitué.

Syntaxe déclarative

<asp:Repeater
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    Visible="True|False"
>
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <SeparatorTemplate>
            <!-- child controls -->
        </SeparatorTemplate>
</asp:Repeater>
TopicLocation
Comment : créer des modèles de contrôle serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET
Comment : répondre à des événements Button dans des éléments des contrôles DataList, Repeater ou GridViewGénération d'applications Web ASP.NET
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter un contrôle Repeater à une page Web FormsGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web Repeater à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Repeater à une page Web FormsGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements de bouton dans des éléments DataList ou RepeaterGénération d'applications Web ASP.NET dans Visual Studio

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

L'exemple de code suivant illustre comment utiliser deux contrôles Repeater simples sur une page. La propriété DataSource est utilisée pour spécifier la source de données pour le contrôle Repeater. Le premier contrôle Repeater affiche ses éléments dans un tableau, tandis que le deuxième contrôle Repeater affiche ses éléments dans une liste avec la virgule comme séparateur.


<%@ 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>
    <title>Repeater Example</title>
<script language="C#" runat="server">
       void Page_Load(Object Sender, EventArgs e) {
          if (!IsPostBack) {
             ArrayList values = new ArrayList();

             values.Add(new PositionData("Microsoft", "Msft"));
             values.Add(new PositionData("Intel", "Intc"));
             values.Add(new PositionData("Dell", "Dell"));

             Repeater1.DataSource = values;
             Repeater1.DataBind();

             Repeater2.DataSource = values;
             Repeater2.DataBind();
          }
       }

       public class PositionData {

          private string name;
          private string ticker;

          public PositionData(string name, string ticker) {
             this.name = name;
             this.ticker = ticker;
          }

          public string Name {
             get {
                return name;
             }
          }

          public string Ticker {
             get {
                return ticker;
             }
          }
       }

    </script>

 </head>
 <body>

    <h3>Repeater Example</h3>

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

       <b>Repeater1:</b>

       <br />

       <asp:Repeater id="Repeater1" runat="server">
          <HeaderTemplate>
             <table border="1">
                <tr>
                   <td><b>Company</b></td>
                   <td><b>Symbol</b></td>
                </tr>
          </HeaderTemplate>

          <ItemTemplate>
             <tr>
                <td> <%# DataBinder.Eval(Container.DataItem, "Name") %> </td>
                <td> <%# DataBinder.Eval(Container.DataItem, "Ticker") %> </td>
             </tr>
          </ItemTemplate>

          <FooterTemplate>
             </table>
          </FooterTemplate>

       </asp:Repeater>
       <br />

       <b>Repeater2:</b>
       <br />
       <asp:Repeater id="Repeater2" runat="server">

          <HeaderTemplate>
             Company data:
          </HeaderTemplate>

          <ItemTemplate>
             <%# DataBinder.Eval(Container.DataItem, "Name") %> (<%# DataBinder.Eval(Container.DataItem, "Ticker") %>)
          </ItemTemplate>

          <SeparatorTemplate>, </SeparatorTemplate>
       </asp:Repeater>
    </form>
 </body>
 </html>
 


L'exemple de code suivant montre comment utiliser la propriété DataSourceID pour spécifier la source de données d'un contrôle Repeater. La propriété DataSourceID a la valeur de la propriété ID du contrôle SqlDataSource utilisé pour récupérer les données. Lorsque la page est chargée, le contrôle Repeater est automatiquement lié à la source de données spécifiée par le contrôle SqlDataSource et les données sont affichées à l'utilisateur.


<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>Repeater.DataSourceID Property Example</title>
</head>

  <body>
    <form id="Form1" runat="server">

      <h3>Repeater.DataSourceID Property Example</h3>

      <asp:repeater id="Repeater1"       
        datasourceid="SqlDataSource1"
        runat="server">

        <headertemplate>
          <table border="1">
            <tr>
              <td><b>Product ID</b></td>
              <td><b>Product Name</b></td>
            </tr>
        </headertemplate>

        <itemtemplate>
          <tr>
            <td> <%# Eval("ProductID") %> </td>
            <td> <%# Eval("ProductName") %> </td>
          </tr>
        </itemtemplate>

        <footertemplate>
          </table>
        </footertemplate>
      </asp:repeater>

            <asp:sqldatasource id="SqlDataSource1"          
            connectionstring="<%$ ConnectionStrings:NorthWindConnection%>" 
        selectcommand="SELECT ProductID, ProductName FROM [Products] Where ProductID <= 10"
        runat="server">
      </asp:sqldatasource>

    </form>      
  </body>
</html>


.NET Framework

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

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft