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

UserControl, classe

Représente un fichier .ascx, également appelé contrôle utilisateur, demandé à un serveur qui héberge une application Web ASP.NET. Le fichier doit être appelé à partir d'une page Web Forms sans quoi l'analyseur génère une erreur.

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

public class UserControl : TemplateControl, 
	IAttributeAccessor, INamingContainer, IUserControlDesignerAccessor

Le type UserControl expose les membres suivants.

  NomDescription
Méthode publiqueUserControlInitialise une nouvelle instance de la classe UserControl.
Début

  NomDescription
Propriété protégéeAdapterObtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueApplicationObtient l'objet Application pour la requête Web en cours.
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é publiqueAppRelativeVirtualPathObtient ou définit le chemin d'accès du répertoire virtuel relatif à l'application qui mène au fichier depuis lequel le contrôle est analysé et compilé. (Hérité de TemplateControl.)
Propriété publiqueAttributesObtient une collection de toutes les paires nom/valeur d'attribut déclarées dans la balise du contrôle utilisateur au sein d'un fichier .aspx.
Propriété protégéeAutoHandlersInfrastructure. Obsolète. La propriété AutoHandlers a été déconseillée dans la version 2.0 d'ASP.NET. Elle est utilisée par les classes générées et n'est pas conçue pour être utilisée dans votre code. (Hérité de TemplateControl.)
Propriété publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publiqueCacheObtient l'objet Cache associé à l'application qui contient le contrôle utilisateur.
Propriété publiqueCachePolicyObtient une référence à une collection de paramètres de mise en cache pour ce contrôle utilisateur.
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 objet ControlCollection qui représente les contrôles enfants d'un contrôle serveur spécifié dans la hiérarchie de l'interface utilisateur. (Hérité de Control.)
Propriété 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é 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 Boolean qui indique si des thèmes s'appliquent au contrôle dérivé de la classe TemplateControl. (Hérité de TemplateControl.)
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é 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é 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é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é publiqueIsPostBackObtient une valeur indiquant si le contrôle utilisateur est en cours de chargement en réponse à une publication (postback) du client ou suite à une première demande d'accès.
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é 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é publiqueRequestObtient l'objet HttpRequest pour la requête Web en cours.
Propriété publiqueResponseObtient l'objet HttpResponse pour la requête Web en cours.
Propriété publiqueServerObtient l'objet HttpServerUtility pour la requête Web en cours.
Propriété publiqueSessionObtient l'objet HttpSessionStatepour la requête Web en cours.
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é protégéeSupportAutoEventsInfrastructure. Obtient une valeur qui indique si le contrôle TemplateControl prend en charge des événements automatiques. (Hérité de TemplateControl.)
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é publiqueTraceObtient l'objet TraceContext pour la requête Web actuelle.
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éeConstructExécute une logique au moment du design. (Hérité de TemplateControl.)
Méthode protégéeCreateChildControlsAppelé par l'infrastructure de page ASP.NET pour avertir les contrôles serveur qui utilisent une implémentation basée sur la composition qu'ils doivent créer tous les contrôles enfants qu'ils contiennent en préparation de la publication ou du rendu. (Hérité de Control.)
Méthode protégé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éeCreateResourceBasedLiteralControlInfrastructure. Accède aux chaînes littérales stockées dans une ressource. La méthode CreateResourceBasedLiteralControl n'est pas conçue pour être utilisée à partir de votre code. (Hérité de TemplateControl.)
Méthode publiqueDataBind()Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control.)
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 publiqueDesignerInitializeEffectue sur le contrôle utilisateur les étapes d'initialisation requises par les concepteurs de développement rapide d'application (RAD, Rapid-Application Development).
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é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éeEval(String)Évalue une expression de liaison de données. (Hérité de TemplateControl.)
Méthode protégéeEval(String, String)Évalue une expression de liaison de données à l'aide de la chaîne de format spécifiée pour afficher le résultat. (Hérité de TemplateControl.)
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éeFrameworkInitializeInfrastructure. Initialise le contrôle dérivé de la classe TemplateControl. (Hérité de TemplateControl.)
Méthode protégéeGetDesignModeStateInfrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode protégéeGetGlobalResourceObject(String, String)Obtient un objet ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées. (Hérité de TemplateControl.)
Méthode protégéeGetGlobalResourceObject(String, String, Type, String)Obtient un objet ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées, un type d'objet et un nom de propriété de la ressource. (Hérité de TemplateControl.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode protégéeGetLocalResourceObject(String)Obtient un objet ressource au niveau de la page selon la propriété ResourceKey spécifiée. (Hérité de TemplateControl.)
Méthode protégéeGetLocalResourceObject(String, Type, String)Obtient un objet ressource au niveau de la page selon les propriétés ResourceKey spécifiée, un type d'objet et un nom de propriété. (Hérité de TemplateControl.)
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 publiqueInitializeAsUserControlInitialise l'objet UserControl créé de manière déclarative. Comme il y a quelques différences entre les pages et les contrôles utilisateur, cette méthode assure une initialisation correcte du contrôle utilisateur.
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 publiqueLoadControl(String)Charge un objet Control à partir d'un fichier en fonction d'un chemin d'accès virtuel spécifié. (Hérité de TemplateControl.)
Méthode publiqueLoadControl(Type, Object[])Charge un objet Control selon un type et des paramètres de constructeur spécifiés. (Hérité de TemplateControl.)
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 publiqueLoadTemplateObtient une instance de l'interface ITemplate à partir d'un fichier externe. (Hérité de TemplateControl.)
Méthode protégéeLoadViewStateRestaure les informations d'état d'affichage à partir d'une requête de contrôle utilisateur antérieure enregistrée par la méthode SaveViewState. (Substitue Control.LoadViewState(Object).)
Méthode publiqueMapPathAssigne un chemin d'accès virtuel, absolu ou relatif, à un chemin d'accès physique à un fichier.
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éeOnAbortTransactionDéclenche l'événement AbortTransaction. (Hérité de TemplateControl.)
Méthode protégéeOnBubbleEventDétermine si l'événement pour le contrôle serveur est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Hérité de Control.)
Méthode protégéeOnCommitTransactionDéclenche l'événement CommitTransaction. (Hérité de TemplateControl.)
Méthode protégéeOnDataBindingDéclenche l'événement DataBinding. (Hérité de Control.)
Méthode protégéeOnErrorDéclenche l'événement Error. (Hérité de TemplateControl.)
Méthode protégéeOnInitDéclenche l'événement Init. (Substitue Control.OnInit(EventArgs).)
Méthode protégéeOnLoadDéclenche l'événement Load. (Hérité de Control.)
Méthode protégéeOnPreRenderDéclenche l'événement PreRender. (Hérité de Control.)
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 publiqueParseControl(String)Analyse une chaîne d'entrée dans un objet Control sur la page Web Forms ou le contrôle utilisateur. (Hérité de TemplateControl.)
Méthode publiqueParseControl(String, Boolean)Analyse une chaîne d'entrée dans un objet Control sur la page Web ASP.NET ou le contrôle utilisateur. (Hérité de TemplateControl.)
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 publiqueReadStringResource()Infrastructure. Lit une ressource de type chaîne. La méthode ReadStringResource n'est pas conçue pour être utilisée à partir de votre code. (Hérité de TemplateControl.)
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 toute modification de l'état d'affichage du contrôle utilisateur survenue depuis la dernière publication (postback) de page. (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 protégéeSetStringResourcePointerInfrastructure. Définit un pointeur sur une ressource de type chaîne. La méthode SetStringResourcePointer est utilisée par des classes générées et n'est pas conçue pour être utilisée dans votre code. (Hérité de TemplateControl.)
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 publiqueTestDeviceFilterRetourne une valeur Boolean qui indique si un filtre pour appareil mobile s'applique à la requête HTTP. (Hérité de TemplateControl.)
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 serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. Cet objet est accessible via la propriété Control.ViewState. (Hérité de Control.)
Méthode publiqueTryUpdateModel<TModel>(TModel)Tente de mettre à jour l'instance de modèle à l'aide des valeurs du contrôle lié aux données.
Méthode publiqueTryUpdateModel<TModel>(TModel, IValueProvider)Tente de mettre à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs.
Méthode publiqueUpdateModel<TModel>(TModel)Met à jour l'instance de modèle à l'aide des valeurs du contrôle lié aux données.
Méthode publiqueUpdateModel<TModel>(TModel, IValueProvider)Met à jour l'instance de modèle spécifiée à l'aide de valeurs provenant du fournisseur de valeur du contrôle utilisateur.
Méthode protégéeWriteUTF8ResourceStringInfrastructure. Écrit une chaîne de ressource dans un contrôle HtmlTextWriter. La méthode WriteUTF8ResourceString est utilisée par des classes générées et n'est pas conçue pour être utilisée dans votre code. (Hérité de TemplateControl.)
Méthode protégéeXPath(String)Évalue une expression de liaison de données XPath. (Hérité de TemplateControl.)
Méthode protégéeXPath(String, String)Évalue une expression de liaison de données XPath à l'aide de la chaîne de format spécifiée pour afficher le résultat. (Hérité de TemplateControl.)
Méthode protégéeXPath(String, IXmlNamespaceResolver)Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms. (Hérité de TemplateControl.)
Méthode protégéeXPath(String, String, IXmlNamespaceResolver)Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms, et de la chaîne de format spécifiée pour afficher le résultat. (Hérité de TemplateControl.)
Méthode protégéeXPathSelect(String)Évalue une expression de liaison de données XPath et retourne une collection de nœuds qui implémente l'interface IEnumerable. (Hérité de TemplateControl.)
Méthode protégéeXPathSelect(String, IXmlNamespaceResolver)Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms, et retourne une collection de nœuds qui implémente l'interface IEnumerable. (Hérité de TemplateControl.)
Début

  NomDescription
Événement publicAbortTransactionSe produit lorsqu'un utilisateur met fin à une transaction. (Hérité de TemplateControl.)
Événement publicCommitTransactionSe produit lorsqu'une transaction se termine. (Hérité de TemplateControl.)
É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 publicErrorSe produit lorsqu'une exception non gérée est levée. (Hérité de TemplateControl.)
É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 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 expliciteMéthode privéeIAttributeAccessor.GetAttributeInfrastructure. Retourne la valeur de l'attribut du contrôle utilisateur spécifié.
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.SetAttributeInfrastructure. Définit la valeur de l'attribut du contrôle utilisateur spécifié.
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éeIFilterResolutionService.CompareFiltersInfrastructure. Retourne une valeur qui indique si une relation parent/enfant existe entre deux filtres pour appareil mobile spécifiés. (Hérité de TemplateControl.)
Implémentation d'interface expliciteMéthode privéeIFilterResolutionService.EvaluateFilterInfrastructure. Retourne une valeur qui indique si le filtre spécifié représente un type de l'objet Filtre actuel. (Hérité de TemplateControl.)
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIUserControlDesignerAccessor.InnerTextInfrastructure. Obtient ou définit le texte compris entre les balises d'ouverture et de fermeture d'un contrôle utilisateur.
Implémentation d'interface explicitePropriété privéeIUserControlDesignerAccessor.TagNameObtient ou définit le nom complet de la balise du contrôle utilisateur.
Début

La classe UserControl est associée aux fichiers ayant une extension .ascx. Ces fichiers sont compilés au moment de l'exécution en tant qu'objets UserControl et mis en cache dans la mémoire du serveur.

Vous pouvez imbriquer des contrôles utilisateur en déclarant un fichier .ascx dans un autre et inclure ce dernier dans une page Web Forms.

Les contrôles utilisateur sont contenus dans des pages Web Forms ASP.NET et facilitent pour les développeurs Web la capture d'interfaces utilisateur Web couramment utilisées. Ils sont instanciés et mis en cache selon des méthodes similaires aux objets Page. À la différence des pages, cependant, les contrôles utilisateur ne peuvent pas être appelés indépendamment. Ils ne peuvent être appelés qu'à partir de la page ou d'un autre contrôle utilisateur les contenant.

Dérivez de cette classe si vous souhaitez créer un contrôle utilisateur en utilisant la technique code-behind. Il s'agit de l'option recommandée si vous utilisez cette technique pour développer des pages Web Forms.

Pour plus d'informations sur la création des contrôles utilisateur par déclaration, consultez Web Forms User Controls.

TopicLocation
Comment : inclure des contrôles utilisateur ASP.NET dans des pages Web (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : créer des contrôles utilisateur ASP.NET (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : mettre en cache plusieurs versions d'un contrôle utilisateur en fonction des paramètresGénération d'applications Web ASP.NET dans Visual Studio
Comment : mettre en cache plusieurs versions d'un contrôle utilisateur en fonction des paramètresGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des contrôles utilisateur ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : convertir des pages Web Forms en contrôles utilisateur ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : traiter un contrôle utilisateur comme un contrôle WebPartGénération d'applications Web ASP.NET dans Visual Studio
Comment : intégrer des contrôles utilisateur ASP.NET dans des pages WebGénération d'applications Web ASP.NET dans Visual Studio
Comment : mettre en cache plusieurs versions d'un contrôle utilisateur en fonction des paramètresGénération d'applications Web ASP.NET
Comment : convertir des pages Web Forms en contrôles utilisateur ASP.NETGénération d'applications Web ASP.NET
Comment : traiter un contrôle utilisateur comme un contrôle WebPartGénération d'applications Web ASP.NET
Comment : créer des contrôles utilisateur ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : convertir des pages Web Forms en contrôles utilisateur ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : traiter un contrôle utilisateur comme un contrôle WebPartGénération d'applications Web ASP.NET dans Visual Studio
Comment : intégrer des contrôles utilisateur ASP.NET dans des pages WebGénération d'applications Web ASP.NET dans Visual Studio

La classe définie dans l'exemple suivant, SimpleControl, hérite de la classe UserControl et peut être utilisée en tant que classe code-behind ASP.NET. Elle utilise les contrôles serveur Web TextBox, Label et Button ; en outre, elle définit une méthode myButton_Click qui assigne la valeur de propriété TextBox.Text, ainsi que deux chaînes, à la propriété Label.Text.

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.


using System;
using System.Web.UI;
using System.Web.UI.WebControls;

public class SimpleControl:UserControl
{

  public TextBox name;
  public Label output;
  public Button myButton;

  public void myButton_Click(object sender, EventArgs e)
  { 
    output.Text = "Hello, " + name.Text + ".";

  }

}


L'exemple suivant représente le balisage contenu dans un fichier .ascx. Vous pouvez utiliser la classe SimpleControl définie dans l'exemple précédent en tant que classe code-behind pour le balisage du fichier .ascx.


<%@ control inherits = "SimpleControl" src = "SimpleControl.cs" %>

<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>


.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
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft