Panel.DefaultButton Propriété

Définition

Obtient ou définit l'identificateur du bouton par défaut contenu dans le contrôle Panel.Gets or sets the identifier for the default button that is contained in the Panel control.

public:
 virtual property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string DefaultButton { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.DefaultButton : string with get, set
Public Overridable Property DefaultButton As String

Valeur de propriété

String

Valeur de chaîne correspondant au ID d'un contrôle de bouton contenu dans Panel.A string value corresponding to the ID for a button control contained in the Panel. La valeur par défaut est une chaîne vide, ce qui indique que le Panel n'a pas de bouton par défaut.The default is an empty string, indicating that the Panel does not have a default button.

Attributs

Remarques

Utilisez la DefaultButton propriété pour indiquer le bouton sur lequel un clic est effectué lorsque le Panel contrôle a le focus et que l’utilisateur appuie sur la touche entrée.Use the DefaultButton property to indicate which button gets clicked when the Panel control has focus and the user presses the ENTER key. DefaultButtonPeut être défini sur l’identificateur d’un Button contrôle ou tout contrôle qui implémente l' IButtonControl interface, à l’exception d’un LinkButton contrôle.The DefaultButton can be set to the identifier for a Button control or any control that implements the IButtonControl interface except a LinkButton control.

Si le DefaultButton est défini sur un contrôle qui n’implémente pas l' IButtonControl interface ou sur un contrôle qui n’est pas contenu dans le Panel contrôle, le Panel contrôle lève une exception lors du rendu.If the DefaultButton is set to a control that does not implement the IButtonControl interface, or to a control that is not contained in the Panel control, the Panel control throws an exception while rendering.

La définition de la DefaultButton propriété n’est pas prise en charge pour les scénarios suivants :Setting the DefaultButton property is not supported for the following scenarios:

  • En définissant le focus en dehors des contrôles d’entrée dans le panneau, puis en appuyant sur la touche entrée.Setting focus outside of the input controls in the panel and then pressing the ENTER key. Le déclenchement de l’action de publication par défaut n’est pas garanti.The default post back action is not guaranteed to trigger.

  • Appuyer sur la touche entrée avec le focus à l’intérieur d’une zone de texte multiligne.Pressing the ENTER key with focus inside a multi-line textbox. Dans une zone de texte multiligne, le fait d’appuyer sur la touche entrée doit créer une nouvelle ligne dans la zone de texte, ce qui correspond au comportement attendu.In a multi-line textbox, pressing the ENTER key should create a new line in the textbox which is the expected behavior. Dans les navigateurs où le fait d’appuyer sur la touche entrée à l’intérieur d’une zone de texte multiligne déclenche une publication, mais que vous souhaitez que la touche entrée crée une nouvelle ligne à la place, vous pouvez attacher une fonction JavaScript au contrôle d’entrée.In browsers where the pressing the ENTER key inside a multi-line textbox triggers a post back but you want the ENTER key to create a new line instead you can attach a JavaScript function to the input control. Le script doit capturer la touche entrée et arrêter la publication.The script should capture the ENTER key and stop the post back. Par exemple, vous pouvez utiliser la Attributes collection de propriétés pour ajouter le script client pour l' onKeyPress événement.For example, you can use the Attributes property collection to add client script for the onKeyPress event.

  • Référencement d’un bouton par défaut qui est un LinkButton contrôle.Referencing a default button that is a LinkButton control. Seuls Button les ImageButton contrôles et sont pris en charge.Only Button and ImageButton controls are supported.

  • Modification DefaultButton par programme au cours d’une publication asynchrone lorsque le Panel contrôle ne se trouve pas à l’intérieur d’un UpdatePanel contrôle.Changing the DefaultButton programmatically during an asynchronous post back when the Panel control is not inside of an UpdatePanel control. Les publications asynchrones peuvent être activées sur une page en ajoutant un ou plusieurs UpdatePanel contrôles à la page.Asynchronous post backs can be enabled on a page by adding one or more UpdatePanel controls to the page. UpdatePanel les contrôles peuvent être utilisés pour mettre à jour les zones sélectionnées d’une page au lieu de mettre à jour la page entière avec une publication (postback).UpdatePanel controls can be used to update selected regions of a page instead of updating the whole page with a postback. Pour plus d’informations, consultez vue d’ensemble du contrôle UpdatePanel et vue d’ensemble du rendu de page partielle.For more information, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

  • Définition de cette propriété par thème ou thème de feuille de style.Setting this property by themes or style sheet themes. Pour plus d’informations, consultez ThemeableAttribute et thèmes et apparences ASP.net.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

S’applique à

Voir aussi