Panel.DefaultButton Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o identificador do botão padrão que está contido no Panel controlo.

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 Propriedade

String

Um valor de cadeia correspondente ao ID para um controlo de botão contido no Panel. O padrão é uma cadeia vazia, indicando que não Panel tem um botão por defeito.

Atributos
ThemeableAttribute

Observações

Use a DefaultButton propriedade para indicar qual botão é clicado quando o Panel controlo tem foco e o utilizador pressiona a tecla ENTER. Pode DefaultButton ser definido para o identificador de um Button controlo ou de qualquer controlo que implemente a IButtonControl interface, exceto um LinkButton controlo.

Se for DefaultButton definido para um controlo que não implementa a IButtonControl interface, ou para um controlo que não está contido no Panel controlo, o controlo Panel lança uma exceção durante a renderização.

A definição da DefaultButton propriedade não é suportada para os seguintes cenários:

  • Definir o foco fora dos controlos de entrada no painel e depois pressionar a tecla ENTER. A ação padrão de post-back não é garantida que seja ativada.

  • Pressionar a tecla ENTER com foco dentro de uma caixa de texto de várias linhas. Numa caixa de texto de várias linhas, pressionar a tecla ENTER deve criar uma nova linha na caixa de texto, o que é o comportamento esperado. Em navegadores onde pressionar a tecla ENTER dentro de uma caixa de texto de várias linhas desencadeia um post de volta, mas se quer que a tecla ENTER crie uma nova linha, pode anexar uma função JavaScript ao controlo de entrada. O script deve captar a tecla ENTER e parar a publicação de volta. Por exemplo, pode usar a Attributes coleção de propriedades para adicionar script cliente para o onKeyPress evento.

  • Referenciando um botão padrão que é um LinkButton controlo. Apenas Button os controlos e ImageButton são suportados.

  • Alterar programaticamente o DefaultButton controlo durante um post assíncrono quando o Panel controlo não está dentro de um UpdatePanel controlo. Os posts backs assíncronos podem ser ativados numa página adicionando um ou mais UpdatePanel controlos à página. UpdatePanel Os controlos podem ser usados para atualizar regiões selecionadas de uma página em vez de atualizar toda a página com um postback. Para mais informações, consulte Visão Geral de Controlo do Painel de Atualização e Partial-Page Visão Geral de Renderização.

  • Definir esta propriedade por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.

Aplica-se a

Ver também