Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Button, classe

.NET Framework 4

Affiche un contrôle bouton de commande sur la page Web.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.Button

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

Le type Button expose les membres suivants.

  Nom Description
Méthode publique Button Initialise une nouvelle instance de la classe Button.
Début
  Nom Description
Propriété publique AccessKey Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl.)
Propriété protégée Adapter Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publique AppRelativeTemplateSourceDirectory Obtient 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é publique Attributes Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl.)
Propriété publique BackColor Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BindingContainer Infrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publique BorderColor Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publique BorderStyle Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BorderWidth Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique CausesValidation Obtient ou définit une valeur indiquant si une validation est effectuée suite à un clic sur le contrôle Button.
Propriété protégée ChildControlsCreated Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publique ClientID Obtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.)
Propriété publique ClientIDMode Obtient 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ée ClientIDSeparator Obtient 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é publique CommandArgument Obtient ou définit un paramètre optionnel passé à l'événement Command avec la propriété CommandName associée.
Propriété publique CommandName Obtient ou définit le nom de la commande associé au contrôle Button qui est passé à l'événement Command.
Propriété protégée Context Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publique Controls Obtient 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é publique ControlStyle Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publique ControlStyleCreated Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publique CssClass Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl.)
Propriété publique DataItemContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publique DataKeysContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété protégée DesignMode Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publique Enabled Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publique EnableTheming Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publique EnableViewState Obtient 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ée Events Obtient 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é publique Font Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publique ForeColor Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique HasAttributes Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégée HasChildViewState Obtient 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é publique Height Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique ID Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégée IdSeparator Infrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégée IsChildControlStateCleared Obtient 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ée IsEnabled Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégée IsTrackingViewState Obtient 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ée IsViewStateEnabled Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété protégée LoadViewStateByID Obtient 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é publique NamingContainer Obtient 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é publique OnClientClick Obtient ou définit le script côté client qui s'exécute lorsque l'événement Click d'un contrôle Button est déclenché.
Propriété publique Page Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publique Parent Obtient 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é publique PostBackUrl Obtient ou définit l'URL de la page sur laquelle publier à partir de la page actuelle suite à un clic sur le contrôle Button.
Propriété publique RenderingCompatibility Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété publique Site Obtient 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é publique SkinID Obtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publique Style Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl.)
Propriété publique SupportsDisabledAttribute Obtient une valeur qui indique si le contrôle doit affecter à l'attribut disabled de l'élément HTML rendu la valeur "disabled" lorsque la propriété IsEnabled du contrôle a la valeur false. (Hérité de WebControl.)
Propriété publique TabIndex Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégée TagKey Obtient la valeur HtmlTextWriterTag qui correspond au contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété protégée TagName Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publique TemplateControl Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publique TemplateSourceDirectory Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publique Text Obtient ou définit la légende de texte affichée dans le contrôle Button.
Propriété publique ToolTip Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl.)
Propriété publique UniqueID Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
Propriété publique UseSubmitBehavior Obtient ou définit une valeur indiquant si le contrôle Button utilise le mécanisme d'envoi du navigateur client ou le mécanisme de publication ASP.NET.
Propriété publique ValidationGroup Obtient ou définit le groupe de contrôles pour lequel le contrôle Button provoque la validation lors de la publication sur le serveur.
Propriété protégée ViewState Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control.)
Propriété protégée ViewStateIgnoresCase Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
Propriété publique ViewStateMode Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publique Visible Obtient 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.)
Propriété publique Width Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début
  Nom Description
Méthode protégée AddAttributesToRender Infrastructure. Ajoute les attributs du contrôle Button au flux de sortie pour le rendre sur le client. (Substitue WebControl.AddAttributesToRender(HtmlTextWriter).)
Méthode protégée AddedControl Appelé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ée AddParsedSubObject Avertit 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 publique ApplyStyle Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode publique ApplyStyleSheetSkin Applique 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ée BuildProfileTree Infrastructure. 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ée ClearCachedClientID Infrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégée ClearChildControlState Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée ClearChildState Supprime 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ée ClearChildViewState Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée ClearEffectiveClientIDMode Infrastructure. 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 publique CopyBaseAttributes Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée CreateChildControls 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. (Hérité de Control.)
Méthode protégée CreateControlCollection Cré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ée CreateControlStyle Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode publique DataBind() 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ée DataBind(Boolean) Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control.)
Méthode protégée DataBindChildren Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publique Dispose Permet à 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ée EnsureChildControls Dé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ée EnsureID Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique FindControl(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ée FindControl(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 publique Focus Affecte le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégée GetDesignModeState Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode protégée GetPostBackOptions Crée un objet PostBackOptions qui représente le comportement du contrôle Button lors de la publication.
Méthode publique GetRouteUrl(Object) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique GetRouteUrl(RouteValueDictionary) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique GetRouteUrl(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 publique GetRouteUrl(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 publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique GetUniqueIDRelativeTo Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publique HasControls Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégée HasEvents Retourne 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ée IsLiteralContent Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégée LoadControlState Restaure 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ée LoadViewState Restaure les informations d'état d'affichage à partir d'une précédente requête enregistrées avec la méthode SaveViewState. (Hérité de WebControl.)
Méthode protégée MapPathSecure Ré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ée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique MergeStyle Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée OnBubbleEvent Dé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ée OnClick Déclenche l'événement Click du contrôle Button.
Méthode protégée OnCommand Déclenche l'événement Command du contrôle Button.
Méthode protégée OnDataBinding Déclenche l'événement DataBinding. (Hérité de Control.)
Méthode protégée OnInit Déclenche l'événement Init. (Hérité de Control.)
Méthode protégée OnLoad Déclenche l'événement Load. (Hérité de Control.)
Méthode protégée OnPreRender Détermine si un clic a été effectué sur le bouton avant son affichage sur le client. (Substitue Control.OnPreRender(EventArgs).)
Méthode protégée OnUnload Déclenche l'événement Unload. (Hérité de Control.)
Méthode protégée OpenFile Obtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégée RaiseBubbleEvent Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégée RaisePostBackEvent Déclenche des événements pour le contrôle Button lorsqu'il publie vers le serveur.
Méthode protégée RemovedControl Appelé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ée Render Génère le rendu du contrôle via le writer HTML spécifié. (Hérité de WebControl.)
Méthode publique RenderBeginTag Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée RenderChildren Renvoie 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 protégée RenderContents Génère le rendu du contenu du contrôle via le writer spécifié. (Substitue WebControl.RenderContents(HtmlTextWriter).)
Méthode publique RenderControl(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ée RenderControl(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 publique RenderEndTag Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégée ResolveAdapter Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publique ResolveClientUrl Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publique ResolveUrl Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégée SaveControlState Enregistre 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ée SaveViewState Enregistre les états modifiés après l'appel de la méthode TrackViewState. (Hérité de WebControl.)
Méthode protégée SetDesignModeState Définit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publique SetRenderMethodDelegate Infrastructure. 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 publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégée TrackViewState Amène le contrôle à suivre les modifications apportées à son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState de l'objet. (Hérité de WebControl.)
Début
  Nom Description
Événement public Click Se produit suite à un clic sur le contrôle Button.
Événement public Command Se produit suite à un clic sur le contrôle Button.
Événement public DataBinding Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement public Disposed Se 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 public Init Se 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 public Load Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement public PreRender Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
Événement public Unload Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début
  Nom Description
Méthode d'extension publique FindDataSourceControl Retourne 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 publique FindFieldTemplate Retourne 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 publique FindMetaTable Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée IAttributeAccessor.GetAttribute Infrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface explicite Méthode privée IAttributeAccessor.SetAttribute Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface explicite Propriété privée IControlBuilderAccessor.ControlBuilder Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.GetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetOwnerControl Infrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IControlDesignerAccessor.UserData Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.DataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.HasDataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.Expressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.HasExpressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IParserAccessor.AddParsedSubObject Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IPostBackEventHandler.RaisePostBackEvent Déclenche des événements pour le contrôle Button lorsqu'il publie vers le serveur.
Début

Dans cette rubrique :

Introduction

Utilisez le contrôle Button pour créer un bouton de commande dans la page Web qui permet aux utilisateurs de publier une page sur un serveur. Le contrôle déclenche un événement dans le code serveur que vous pouvez gérer pour répondre à la publication. Il peut également déclencher un événement dans le script client que vous pouvez gérer avant que la page soit publiée ou qui peut s'exécuter, puis annuler la soumission de la page.

Remarque Remarque

ASP.NET inclut plusieurs types des contrôles bouton, chacun s'affichant différemment sur les pages Web. Il s'agit du contrôle Button, qui est restitué sous la forme d'un bouton de commande ; du contrôle LinkButton, qui est restitué sous la forme d'un lien ; du contrôle ImageButton, qui est restitué sous la forme d'image et du contrôle ImageMap, qui vous permet de créer un graphique avec des zones réactives sur lesquelles les utilisateurs peuvent cliquer. Par défaut, tous les contrôles bouton envoient la page lorsque l'utilisateur clique dessus. Vous pouvez également utiliser les contrôles HtmlButton et HtmlInputButton pour créer dans la page des boutons programmables dans le code serveur. Pour plus d'informations sur les différences entre les contrôles serveur Web et HTML, consultez Vue d'ensemble des contrôles serveur Web ASP.NET.

Par défaut, un contrôle Button est un bouton de type "Submit". Un bouton de type "Submit" n'a pas de nom de commande (spécifié par la propriété CommandName) associé au bouton et publie simplement la page Web sur le serveur. Vous pouvez fournir un gestionnaire d'événements pour l'événement Click afin de contrôler par programme les actions exécutées suite à un clic sur le bouton de type "Submit".

Un bouton de commande a un nom de commande associé au bouton, tel que Sort, en définissant la propriété CommandName. Cela vous permet de créer plusieurs contrôles Button sur une page Web et de déterminer par programme sur quel contrôle Button un clic a été effectué. Vous pouvez également utiliser la propriété CommandArgument avec un bouton de commande pour fournir des informations supplémentaires, telles que Ascending sur la commande à effectuer. Vous pouvez fournir un gestionnaire d'événements pour l'événement Command afin de contrôler par programme les actions exécutées suite à un clic sur le bouton de commande.

Comportement de la publication du bouton et événements de serveur

Lorsqu'un utilisateur clique sur un bouton de contrôle serveur Web, la page est envoyée au serveur. Cela déclenche le traitement de la page Web et celui des événements en attente dans le code serveur. Lorsque tout le traitement de page et de contrôle est terminé, la page s'affiche de nouveau dans le navigateur.

Les boutons peuvent déclencher leurs propres événements Click ou l'événement Command, que vous pouvez gérer à l'aide de code serveur. C'est différent des événements dans des pages HTML traditionnelles ou dans des applications Web basées sur client, où l'événement onclick d'un bouton est contrôlé à l'aide de JavaScript qui s'exécute dans le client. Pour plus d'informations, consultez Modèle d'événements du contrôle serveur Web ASP.NET.

Lorsque l'utilisateur clique sur un contrôle de bouton, la page est publiée en retour sur le serveur. Par défaut, la page est publiée vers elle-même.

Vous pouvez configurer des boutons pour publier la page actuelle sur une autre page. Cela peut être utile pour la création de formulaires composés de plusieurs pages. Pour plus d'informations, consultez Publication sur plusieurs pages dans des pages Web ASP.NET.

Gestion d'événements de bouton dans le script client

Les contrôles de bouton peuvent déclencher à la fois des événements serveur et des événements client. Les événements serveur se produisent après la publication et sont gérés dans le code côté serveur que vous écrivez pour la page. Les événements client sont gérés dans le script client, généralement ECMAScript (JavaScript) et sont déclenchés avant que la page ne soit envoyée. En ajoutant des événements côté client aux contrôles de bouton ASP.NET, vous pouvez exécuter des tâches telles que l'affichage de boîtes de dialogue de confirmation avant d'envoyer la page et éventuellement annuler l'envoi. Pour plus d'informations, consultez Script client dans les pages Web ASP.NET et Comment : répondre à des événements du contrôle serveur Web bouton dans un script client.

Vous pouvez souhaiter également que le contrôle Button utilise également le script client pour exécuter la publication (postback) (au lieu d'exécuter simplement une opération HTTP POST). Ainsi, vous pouvez manipuler la publication par programme, par exemple en la joignant aux autres éléments de la page. Vous pouvez affecter la valeur true à la propriété UseSubmitBehavior du contrôle Button pour que le contrôle Button utilise la publication basée sur le script client.

Contrôles et validation de bouton

Si une page contient des contrôles validateurs ASP.NET, par défaut, en cliquant sur un contrôle de bouton, le contrôle validateur effectue sa vérification. Si la validation côté client est activée pour un contrôle validateur, la page n'est pas envoyée si une vérification de la validation a échoué.

Le tableau suivant décrit les propriétés prises en charge par les contrôles de bouton qui vous permettent de contrôler le processus de validation de manière plus précise.

Propriété

Description

CausesValidation

Spécifie si le fait de cliquer sur le bouton permet également d'effectuer une vérification de la validation. L'affectation de la valeur false à la propriété permet d'empêcher une vérification de la validation.

ValidationGroup

Vous permet de spécifier les validateurs de la page appelés lorsque vous cliquez sur le bouton. Si aucun groupe de validation n'est établi et que vous cliquez sur un bouton, tous les validateurs qui figurent sur la page sont appelés.

Pour plus d'informations, consultez Validation des entrées d'utilisateur dans des pages Web ASP.NET.

Boutons des contrôles de données

Les contrôles serveur Web de bouton sont souvent utilisés dans les contrôles de données tels que les contrôles de liste DataListGridViewet Repeater. Dans ces cas, vous ne répondez généralement pas directement à l'événement lié à un clic sur un bouton. À la place, un bouton dans un contrôle de données déclenche un événement qui est spécifique au contrôle de données. Par exemple, dans le contrôle DataList, un bouton peut déclencher l'événement ItemCommand du contrôle DataList plutôt que l'événement Click du contrôle Button.

Étant donné que les contrôles de liste liés aux données peuvent contenir de nombreux boutons, vous pouvez définir la propriété CommandArgument du bouton pour spécifier une valeur à passer dans le cadre de l'événement. Vous pouvez alors tester cet argument pour savoir sur quel bouton l'utilisateur a cliqué.

Liaison de données aux contrôles

Vous pouvez lier les contrôles serveur Web de bouton à une source de données afin de contrôler dynamiquement leurs paramètres de propriété. Par exemple, vous pouvez définir la propriété Text d'un bouton à l'aide de la liaison de données.

Utilisation de boutons avec les contrôles UpdatePanel

Le rendu de page partielle permet d'actualiser des parties d'une page sans publication (postback). Les contrôles UpdatePanel vous permettent de marquer des parties de pages qui participent au rendu de page partielle. Par défaut, le comportement de contrôles à l'intérieur d'un contrôle UpdatePanel, notamment les contrôles Button, consiste à exécuter une publication (postback) asynchrone au lieu d'une publication (postback). Cela actualise uniquement le contenu du contrôle UpdatePanel duquel la publication (postback) provient.

En plus du scénario d'un contrôle Button qui est à l'intérieur d'un contrôle UpdatePanel, vous pouvez utiliser les contrôles Button avec les contrôles UpdatePanel dans les scénarios suivants :

  • Définition d'un contrôle Button qui est à l'extérieur d'un contrôle UpdatePanel comme un contrôle AsyncPostBackTrigger pour ce panneau. Un clic de bouton exécute une publication (postback) asynchrone et actualise le contenu du panneau.

  • Définition d'un contrôle Button qui est à l'intérieur d'un contrôle UpdatePanel comme un PostBackTrigger pour le panneau. Un clic de bouton exécute une publication (postback) bien qu'elle se trouve dans un contrôle UpdatePanel.

Pour plus d'informations sur le rendu de page partiel et l'utilisation de contrôles UpdatePanel, consultez Vue d'ensemble du contrôle UpdatePanel et Vue d'ensemble du rendu de page partielle.

Syntaxe déclarative

Copier 
<asp:Button
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    UseSubmitBehavior="True|False"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

L'exemple de code suivant montre comment créer un contrôle Button Envoyer qui publie le contenu de la page Web sur le serveur.

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>Button Example</title>
<script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         Message.Text="Hello World!!";
      }

   </script>
</head>
<body>
   <form id="form1" runat="server">

      <h3>Button Example</h3>

      Click on the submit button.<br /><br />

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="SubmitBtn_Click" 
           runat="server"/>

      <br />

      <asp:label id="Message" runat="server"/>

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

L'exemple de code suivant montre comment créer un contrôle Button de commande qui trie une liste.

C#
VB
Copier 

<%@ Page Language="C#" AutoEventWireup="True" %>

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

      void CommandBtn_Click(Object sender, CommandEventArgs e) 
      {

         switch(e.CommandName)
         {

            case "Sort":

               // Call the method to sort the list.
               Sort_List((String)e.CommandArgument);
               break;

            case "Submit":

               // Display a message for the Submit button being clicked.
               Message.Text = "You clicked the Submit button";

               // Test whether the command argument is an empty string ("").
               if((String)e.CommandArgument == "")
               {
                  // End the message.
                  Message.Text += ".";
               }
               else
               {
                  // Display an error message for the command argument. 
                  Message.Text += ", however the command argument is not recogized.";
               }                
               break;

            default:

               // The command name is not recognized. Display an error message.
               Message.Text = "Command name not recogized.";
               break; 

         }

      }

      void Sort_List(string commandArgument)
      {

         switch(commandArgument)
         {

            case "Ascending":

               // Insert code to sort the list in ascending order here.
               Message.Text = "You clicked the Sort Ascending button.";
               break;

            case "Descending":

               // Insert code to sort the list in descending order here.
               Message.Text = "You clicked the Sort Descending button.";
               break;

            default:

               // The command argument is not recognized. Display an error message.
               Message.Text = "Command argument not recogized.";
               break;

         }

      }

   </script>

</head>

<body>

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

      <h3>Button CommandName Example</h3>

      Click on one of the command buttons.

      <br /><br />

      <asp:Button id="Button1"
           Text="Sort Ascending"
           CommandName="Sort"
           CommandArgument="Ascending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <asp:Button id="Button2"
           Text="Sort Descending"
           CommandName="Sort"
           CommandArgument="Descending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      <br /><br />

      <asp:Button id="Button3"
           Text="Submit"
           CommandName="Submit"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <asp:Button id="Button4"
           Text="Unknown Command Name"
           CommandName="UnknownName"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <asp:Button id="Button5"
           Text="Submit Unknown Command Argument"
           CommandName="Submit"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      <br /><br />

      <asp:Label id="Message" runat="server"/>

   </form>

</body>
</html>

.NET Framework

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

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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)
Contenu de la communauté Ajouter
Annotations FAQ
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,
Confidentialité