HtmlForm.DefaultButton Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o controle filho do controle HtmlForm que causa o postback quando a tecla ENTER é pressionada.
public:
property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };public string DefaultButton { get; set; }member this.DefaultButton : string with get, setPublic Property DefaultButton As StringValor da propriedade
O ID do controle de botão para ser exibido como o botão padrão quando o HtmlForm é carregado. O valor padrão é uma cadeia de caracteres vazia ("").
Exceções
O controle referenciado como o botão padrão não é do tipo IButtonControl.
Exemplos
O exemplo a seguir mostra como definir a DefaultButton propriedade para definir o controle padrão que causa um postback.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Load(object sender, System.EventArgs e)
{
// Set the text of the two label controls.
Label1.Text = "The DefaultButton property is set to "
+ Form1.DefaultButton.ToString() + "<br/>";
Label2.Text = "The DefaultFocus property is set to "
+ Form1.DefaultFocus.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>
</head>
<body>
<form id="Form1"
defaultbutton="SubmitButton"
defaultfocus="TextBox1"
runat="server">
<h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>
TextBox1:
<asp:textbox id="TextBox1"
autopostback="true"
runat="server">
</asp:textbox>
<br />
TextBox2:
<asp:textbox id="TextBox2"
autopostback="true"
runat="server">
</asp:textbox>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
runat="server">
</asp:button>
<asp:button id="CancelButton"
text="Cancel"
runat="server">
</asp:button>
<hr />
<asp:label id="Label1"
runat="Server">
</asp:label>
<asp:label id="Label2"
runat="Server">
</asp:label>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="Server">
Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' Set the text of the two label controls.
Label1.Text = "The DefaultButton property is set to " _
& Form1.DefaultButton.ToString & "<br/>"
Label2.Text = "The DefaultFocus property is set to " _
& Form1.DefaultFocus.ToString
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>
</head>
<body>
<form id="Form1"
defaultbutton="SubmitButton"
defaultfocus="TextBox1"
runat="server">
<h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>
TextBox1:
<asp:textbox id="TextBox1"
autopostback="true"
runat="server">
</asp:textbox>
<br />
TextBox2:
<asp:textbox id="TextBox2"
autopostback="true"
runat="server">
</asp:textbox>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
runat="server">
</asp:button>
<asp:button id="CancelButton"
text="Cancel"
runat="server">
</asp:button>
<hr />
<asp:label id="Label1"
runat="Server">
</asp:label>
<asp:label id="Label2"
runat="Server">
</asp:label>
</form>
</body>
</html>
Comentários
A DefaultButton propriedade permite que você especifique que os usuários podem causar um postback pressionando ENTER em um controle de entrada no formulário (como uma caixa de texto). Você pode especificar como um botão padrão qualquer controle que deriva da IButtonControl interface, exceto o LinkButton controle. Se o controle referenciado pela DefaultButton propriedade não derivar, IButtonControluma exceção InvalidOperationException será gerada.
Se você estiver usando páginas mestras e definir a DefaultButton propriedade de uma página de conteúdo, use a UniqueID propriedade do IButtonControl botão. Para obter mais informações sobre páginas mestras, consulte ASP.NET Páginas Mestras.
A DefaultButton propriedade pode não causar um postback nos seguintes cenários:
Pressione ENTER quando o foco estiver fora dos controles de entrada no formulário. Não há garantia de que a ação de postback padrão seja disparada.
Pressione ENTER quando o foco estiver dentro de uma caixa de texto de várias linhas. Em uma caixa de texto de várias linhas, o comportamento esperado é que pressionar ENTER cria uma nova linha na caixa de texto. Em alguns navegadores, pressionar ENTER dentro de uma caixa de texto de várias linhas dispara um postback. Nesse caso, se você quiser que ENTER crie uma nova linha, você poderá anexar uma função JavaScript ao controle de entrada. O script deve capturar a chave ENTER e interromper o postback. Por exemplo, você pode usar a Attributes coleção de propriedades para adicionar o script do cliente para o
onKeyPressevento.Especificando um LinkButton controle como um botão padrão. Somente Button e ImageButton controles são compatíveis.
Alterando a DefaultButton propriedade programaticamente durante um postback assíncrono. Postbacks assíncronos podem ser habilitados em uma página adicionando um ou mais UpdatePanel controles à página. Para obter mais informações, consulte Visão geral do controle UpdatePanel e visão geral da renderização de página parcial.