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 Panel controle.

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 correspondente ao ID de um controle de botão contido no Panel. O padrão é uma cadeia de caracteres vazia, indicando que o Panel botão não tem um 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 identificador pode ser definido para um Button controle ou qualquer controle que implemente a IButtonControl interface, exceto um LinkButton controle.

Se o DefaultButton controle for 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. A ação pós-back padrão não é garantida para disparar.

• 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, em vez disso, 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. Somente Button e ImageButton controles são compatíveis.

• Alterando a DefaultButton programação durante uma postagem assíncrona quando o Panel controle não estiver 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 as 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 Partial-Page visão geral da renderização.

• 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