Panel.DefaultButton Propiedad

Definición

Obtiene o establece el identificador del botón predeterminado incluido en el control 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

Valor de propiedad

Valor de cadena que corresponde a ID de un control de botón incluido en Panel. El valor predeterminado es una cadena vacía, que indica que Panel no tiene un botón predeterminado.

Atributos

Comentarios

Utilice la DefaultButton propiedad para indicar qué botón se hace clic cuando el Panel control tiene el foco y el usuario presiona la tecla ENTRAR. DefaultButton se puede establecer en el identificador de un Button control o cualquier control que implemente la IButtonControl interfaz excepto un LinkButton control .

Si se establece en DefaultButton un control que no implementa la IButtonControl interfaz o en un control que no está incluido en el Panel control , el Panel control produce una excepción mientras se representa.

No se admite la configuración de la DefaultButton propiedad para los escenarios siguientes:

  • Establecer el foco fuera de los controles de entrada en el panel y presionar la tecla ENTRAR. No se garantiza que la acción posterior predeterminada se desencadene.

  • Presionando la tecla ENTRAR con el foco dentro de un cuadro de texto de varias líneas. En un cuadro de texto de varias líneas, al presionar la tecla ENTRAR se debe crear una nueva línea en el cuadro de texto, que es el comportamiento esperado. En los exploradores en los que al presionar la tecla ENTRAR dentro de un cuadro de texto de varias líneas se desencadena una entrada atrás, pero desea que la tecla ENTRAR cree una nueva línea, en su lugar, puede adjuntar una función de JavaScript al control de entrada. El script debe capturar la tecla ENTRAR y detener la publicación. Por ejemplo, puede usar la Attributes colección de propiedades para agregar un script de cliente para el onKeyPress evento.

  • Hacer referencia a un botón predeterminado que es un LinkButton control . Solo Button se admiten los controles y ImageButton .

  • Cambiar el objeto DefaultButton mediante programación durante una publicación asincrónica cuando el Panel control no está dentro de un UpdatePanel control. Los retrocesos de publicación asincrónicos se pueden habilitar en una página agregando uno o varios UpdatePanel controles a la página. UpdatePanel Los controles se pueden usar para actualizar las regiones seleccionadas de una página en lugar de actualizar toda la página con un postback. Para obtener más información, vea UpdatePanel Control Overview y Partial-Page Rendering Overview.

  • Establecer esta propiedad por temas o temas de hojas de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también