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

Repeater, classe

.NET Framework 4.5

Un contrôle de liste liée aux données qui permet la disposition personnalisée en répétant un modèle spécifié pour chaque élément s'affiche dans la liste.

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

Le type Repeater expose les membres suivants.

  NomDescription
Méthode publiqueRepeaterInitialise une nouvelle instance de la classe d' Repeater .
Début
  NomDescription
Propriété protégéeAdapterObtient l'adaptateur spécifiques au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAlternatingItemTemplateObtient ou définit l'objet qui implémente System.Web.UI.ITemplate qui définit comment les éléments de remplacement dans le contrôle sont affichés.
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é 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 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 System.Web.UI.ControlCollection qui contient des contrôles enfants du contrôle d' Repeater . (Substitue Control.Controls.)
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 met la table spécifique dans DataSource à lier au contrôle.
Propriété publiqueDataSourceObtient ou définit la source de données qui fournit des données pour remplir la liste.
Propriété publiqueDataSourceIDObtient ou définit la propriété d' ID du contrôle de source de données que le contrôle d' Repeater doit utiliser pour récupérer la 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 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é publiqueFooterTemplateObtient ou définit System.Web.UI.ITemplate qui définit comment la section de pied de page du contrôle d' Repeater s'affiche.
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é publiqueHeaderTemplateObtient ou définit System.Web.UI.ITemplate qui définit comment la section d'en-tête du contrôle d' Repeater s'affiche.
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é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é d' DataSourceID est définie.
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.
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 d' RepeaterItem dans le contrôle d' Repeater .
Propriété publiqueItemTemplateObtient ou définit System.Web.UI.ITemplate qui définit la façon dont les éléments du contrôle de Repeater sont affichés.
Propriété publiqueItemTypeLe nom du type de modèle pour la liaison de données fortement typée.
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 Repeater le contrôle de se lier à sa source de données spécifiée.
Propriété protégéeSelectArgumentsInfrastructure. Obtient un objet d' DataSourceSelectArguments que le contrôle d' Repeater utilise lorsqu'il récupère des données d'un contrôle de source de données.
Propriété publiqueSelectMethodLe nom de la méthode à appeler pour pouvoir lire des données.
Propriété publiqueSeparatorTemplateObtient ou définit l'interface d' System.Web.UI.ITemplate qui définit la façon dont le séparateur entre des éléments s'affiche.
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 d'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 d' Page ou d' UserControl qui contient le contrôle serveur actuel. (Hérité de Control.)
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é 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.)
Début
  NomDescription
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 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 protégéeCreateChildControlsInfrastructure. Appelé 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. (Substitue Control.CreateChildControls().)
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éeCreateControlHierarchyInfrastructure. Crée une hiérarchie de contrôle, avec ou sans la source de données spécifiée.
Méthode protégéeCreateDataSourceSelectArgumentsInfrastructure. Retourne la valeur d' Empty .
Méthode protégéeCreateItemInfrastructure. Crée un objet d' RepeaterItem avec le type d'élément spécifié et l'emplacement dans le contrôle d' Repeater .
Méthode publiqueDataBind()Infrastructure. Lie le contrôle d' 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 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éeEnsureDataBoundVérifie que le contrôle d' 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 d' DataBind .
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éeGetDataInfrastructure. Retourne une interface d' IEnumerable de la source de données.
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éeInitializeItemInfrastructure. Remplit de manière itérative RepeaterItem spécifié avec une Sub-hiérarchie des contrôles enfants.
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éeLoadViewStateRestaure les informations d'état d'affichage d'une demande de page précédente qui a été enregistrée à l'aide de la méthode d' 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, tables. (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 d' ItemCommand si le paramètre d' EventArgs est une instance d' RepeaterCommandEventArgs. (Substitue Control.OnBubbleEvent(Object, EventArgs).)
Méthode protégéeOnCreatingModelDataSourceDéclenche l'événement d' CreatingModelDataSource .
Méthode protégéeOnDataBindingInfrastructure. Déclenche l'événement d' DataBinding . (Substitue Control.OnDataBinding(EventArgs).)
Méthode protégéeOnDataPropertyChangedInfrastructure. Détermine si la liaison de données est requise.
Méthode protégéeOnDataSourceViewChangedDéfinit la propriété d' RequiresDataBinding à true.
Méthode protégéeOnInitDéclenche l'événement d' Init . (Substitue Control.OnInit(EventArgs).)
Méthode protégéeOnItemCommandDéclenche l'événement d' ItemCommand .
Méthode protégéeOnItemCreatedDéclenche l'événement d' ItemCreated .
Méthode protégéeOnItemDataBoundDéclenche l'événement d' ItemDataBound .
Méthode protégéeOnLoadDéclenche l'événement d' Load et effectue d'autres initialisation. (Substitue Control.OnLoad(EventArgs).)
Méthode protégéeOnPreRenderDéclenche l'événement d' PreRender . (Substitue Control.OnPreRender(EventArgs).)
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é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éeRenderEnvoie le contenu de contrôle serveur à un objet fourni d' HtmlTextWriter , qui écrit le contenu à afficher sur le client. (Hérité de Control.)
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 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 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 toutes les modifications de l'état d'affichage qui se sont produites étant donné que le temps que la page a été publiée sur le serveur. (Substitue Control.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 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éeTrackViewStateProvoque le suivi des modifications d'état d'affichage au contrôle de sorte qu'ils peuvent être stockés dans l'objet d' 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 d' 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 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 publicItemCommandSe produit lorsqu'un clic est effectué dans le contrôle d' Repeater .
Événement publicItemCreatedSe produit lorsqu'un élément est créé dans le contrôle d' Repeater .
Événement publicItemDataBoundSe produit après qu'un élément dans le contrôle d' Repeater soit lié aux données mais avant qu'elle apparaît sur la page.
É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 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 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

Dans cette rubrique :

Introduction

Le contrôle d' Repeater est une liste liée aux données basée sur un modèle de base. Il n'a aucune disposition ou style intégrée, vous devez déclarer explicitement tous les disposition, la mise en forme, les balises et de style dans les modèles du contrôle.

Le contrôle d' Repeater vous permet de définir des instructions de balisage fractionnées entre les modèles. Pour créer un tableau à l'aide de modèles, incluez l'indicateur de tableau de démarrer (<table>) dans HeaderTemplate, une balise unique de ligne de la table (<tr>) dans ItemTemplate, et l'indicateur de tableau de fin (</table>) dans FooterTemplate.

Le contrôle d' Repeater n'a aucune fonction de sélection ou prise en charge intégrée de modification. Vous pouvez utiliser l'événement d' ItemCommand aux événements de contrôle de traitement qui sont déclenchés des modèles au contrôle.

Mise en gardeAttention

Ce contrôle permet d'afficher l'entrée d'utilisateur, ce qui peut inclure un script client nuisible. Vérifiez toutes les informations envoyées par un client pour le script exécutable, les instructions SQL, ou un autre code avant de l'afficher dans votre application. ASP.NET fournit une fonctionnalité d'entrée de validation de la demande de bloquer le script et HTML dans les entrées d'utilisateur. Les contrôles serveur de validation est également fourni pour évaluer l'entrée d'utilisateur. Pour plus d'informations, consultez Syntaxe des contrôles serveur de validation.

Liaison de données

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

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

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

Modèles

Au minimum, chaque contrôle d' Repeater doit définir ItemTemplate. Toutefois, d'autres modèles facultatifs décrits dans le tableau suivant peuvent être utilisés pour personnaliser l'apparence 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 requis.

AlternatingItemTemplate

S'il est défini, détermine le contenu et la disposition (de base zéro étrange-indexé) des éléments remplacement. Si sa, ItemTemplate est utilisé.

SeparatorTemplate

S'il est défini, est affiché entre des éléments (et les éléments de remplacement). Si sa, un délimiteur est pas affiché.

HeaderTemplate

S'il est défini, détermine le contenu et la disposition de l'en-tête de liste. Si sa, un en-tête n'est pas affiché.

FooterTemplate

S'il est défini, détermine le contenu et la disposition du pied de page liste. Si sa, un pied de page n'est pas affiché.

Syntaxe déclarative

Copier 
<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 : téléchargement.

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

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>
    <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é d' DataSourceID pour spécifier la source de données pour un contrôle d' Repeater . La propriété d' DataSourceID est définie sur la propriété d' ID du contrôle d' SqlDataSource utilisé pour récupérer les données. Lorsque la page est chargée, le contrôle d' Repeater le est automatiquement lié à la source de données spécifiée par le contrôle d' SqlDataSource et les données sont affichées à l'utilisateur.

C#
VB
Copier 

<%@ 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, 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.