Panel.DefaultButton Propriété

Définition

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

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 au ID d'un contrôle de bouton contenu dans 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.

Attributs

Remarques

Utilisez la DefaultButton propriété pour indiquer quel bouton est cliqué lorsque le Panel contrôle est activé et que l’utilisateur appuie sur la touche ENTRÉE. Le DefaultButton peut être défini sur l’identificateur d’un Button contrôle ou de tout contrôle qui implémente l’interface, à l’exception IButtonControl d’un LinkButton contrôle.

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

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

  • Définition du focus en dehors des contrôles d’entrée dans le panneau, puis appuyez sur la touche ENTRÉE. Le déclenchement de l’action post-retour par défaut n’est pas garanti.

  • Appuyez sur la touche ENTRÉE avec le focus dans une zone de texte multiligne. Dans une zone de texte multiligne, l’appui sur la touche ENTRÉE doit créer une ligne dans la zone de texte qui correspond au comportement attendu. Dans les navigateurs où le fait d’appuyer sur la touche ENTRÉE à l’intérieur d’une zone de texte multiligne déclenche un post-back, 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 Attributes propriétés pour ajouter un script client pour l’événement onKeyPress .

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

  • Modification du DefaultButton par programmation pendant une post-retour asynchrone lorsque le Panel contrôle n’est pas à l’intérieur d’un UpdatePanel contrôle. Les post-retours 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 Vue d’ensemble du contrôle UpdatePanel et Vue d’ensemble du rendu de page partielle.

  • 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 skins.

S’applique à

Voir aussi