Panel.DefaultButton Propriedade

Definição

Obtém ou define o identificador do botão padrão contido no controle Panel.

[System.Web.UI.Themeable(false)]
public virtual string DefaultButton { get; set; }

Valor da propriedade

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

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.

Aplica-se a

Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também