Panel.DefaultButton Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Obtém ou define o identificador do botão padrão contido no controle 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 da propriedade

String

Um valor de cadeia de caracteres que corresponde ao ID para um controle de botão contido no Panel. O padrão é uma cadeia de caracteres vazia, indicando que o Panel não tem um botão padrão.

Atributos

ThemeableAttribute

Comentários

Use a DefaultButton propriedade para indicar qual botão é clicado quando o Panel controle tem foco e o usuário pressiona a tecla ENTER. O DefaultButton pode ser definido como o identificador de um Button controle ou qualquer controle que implemente a IButtonControl interface, exceto um LinkButton controle.

Se o DefaultButton estiver definido como um controle que não implementa a IButtonControl interface ou para um controle que não está contido no Panel controle, o Panel controle gerará uma exceção durante a renderização.

Não há suporte para a definição da DefaultButton propriedade para os seguintes cenários:

• Definindo o foco fora dos controles de entrada no painel e pressionando a tecla ENTER. Não há garantia de que a ação pós-back padrão seja disparada.

• Pressionando a tecla ENTER com foco dentro de uma caixa de texto de várias linhas. Em uma caixa de texto de várias linhas, pressionar a tecla ENTER deve criar uma nova linha na caixa de texto que é o comportamento esperado. Em navegadores em que pressionar a tecla ENTER dentro de uma caixa de texto de várias linhas dispara uma postagem de volta, mas você deseja que a chave ENTER crie uma nova linha, você pode anexar uma função JavaScript ao controle de entrada. O script deve capturar a chave ENTER e parar a postagem de volta. Por exemplo, você pode usar a Attributes coleção de propriedades para adicionar o script do cliente para o onKeyPress evento.

• Referenciando um botão padrão que é um LinkButton controle. Há suporte apenas Button para controles e ImageButton .

• Alterando o DefaultButton programaticamente durante uma postagem assíncrona quando o Panel controle não está dentro de um UpdatePanel controle. Os postbacks assíncronos podem ser habilitados em uma página adicionando um ou mais UpdatePanel controles à página. UpdatePanel os controles podem ser usados para atualizar regiões selecionadas de uma página em vez de atualizar a página inteira com um postback. Para obter mais informações, consulte Visão geral do controle UpdatePanel e Visão geral da renderização de página parcial.

• Definindo essa propriedade por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.

Confira também

• OnClick(EventArgs)
• Click