Partager via


Panel.DefaultButton Propriété

Définition

Obtient ou définit l’identificateur du bouton par défaut contenu dans le Panel contrôle.

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é

Valeur de chaîne correspondant à la ID valeur d’un contrôle bouton contenu dans le Panel. La valeur par défaut est une chaîne vide, indiquant que le Panel bouton par défaut n’est pas disponible.

Attributs

Remarques

Utilisez la DefaultButton propriété pour indiquer quel bouton est cliqué lorsque le Panel contrôle a le focus et que l’utilisateur appuie sur la touche Entrée. Il DefaultButton peut être défini sur l’identificateur d’un Button contrôle ou tout contrôle qui implémente l’interface IButtonControl à l’exception d’un LinkButton contrôle.

Si la DefaultButton valeur est définie sur un contrôle qui n’implémente pas l’interface IButtonControl ou sur un contrôle qui n’est pas contenu dans le contrôle, le Panel contrôle lève une exception lors du Panel rendu.

La définition de la DefaultButton propriété n’est pas prise en charge pour les scénarios suivants :

  • Définition du focus en dehors des contrôles d’entrée dans le panneau, puis en appuyant sur la touche Entrée. L’action de publication par défaut n’est pas garantie de déclencher.

  • Appuyez sur la touche ENTRÉE avec focus à l’intérieur d’une zone de texte à plusieurs lignes. Dans une zone de texte à plusieurs lignes, l’appui sur la touche Entrée doit créer une ligne dans la zone de texte qui est le comportement attendu. Dans les navigateurs où l’appui sur la touche ENTRÉE à l’intérieur d’une zone de texte à plusieurs lignes déclenche un billet de retour, mais que vous souhaitez que la touche ENTRÉE crée une ligne à la place, vous pouvez attacher une fonction JavaScript au contrôle d’entrée. Le script doit capturer la clé ENTRÉE et arrêter la publication. Par exemple, vous pouvez utiliser la collection de propriétés pour ajouter un Attributes script client pour l’événement onKeyPress .

  • Référencement d’un bouton par défaut qui est un LinkButton contrôle. Seuls Button et ImageButton les contrôles sont pris en charge.

  • DefaultButton Modification programmatique pendant un post-retour asynchrone lorsque le Panel contrôle n’est pas à l’intérieur d’un UpdatePanel contrôle. Les post-backs asynchrones peuvent être activés sur une page en ajoutant un ou plusieurs UpdatePanel contrôles à la page. UpdatePanel les contrôles peuvent être utilisés pour mettre à jour les régions sélectionnées d’une page au lieu de mettre à jour l’ensemble de la page avec une publication. Pour plus d’informations, consultez UpdatePanel Control Overview et Partial-Page Rendering Overview.

  • Définition de cette propriété par thèmes ou thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes et peaux.

S’applique à

Voir aussi