HtmlForm.DefaultButton Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il controllo figlio del controllo HtmlForm che determina il postback quando viene premuto INVIO.
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 StringValore della proprietà
Controllo ID del controllo pulsante da visualizzare come pulsante predefinito quando viene caricato il controllo HtmlForm. Il valore predefinito è una stringa vuota ("").
Eccezioni
Il tipo del controllo indicato come pulsante predefinito non è IButtonControl.
Esempio
Nell'esempio seguente viene illustrato come impostare la proprietà per impostare il DefaultButton controllo predefinito che causa un 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>
Commenti
La DefaultButton proprietà consente di specificare che gli utenti possono causare un postback premendo INVIO in un controllo di input nel modulo , ad esempio una casella di testo. È possibile specificare come pulsante predefinito qualsiasi controllo che deriva dall'interfaccia, ad eccezione del IButtonControlLinkButton controllo. Se il controllo a cui fa riferimento la DefaultButton proprietà non deriva da IButtonControl, viene generata un'eccezione InvalidOperationException .
Se si usano pagine master e si imposta la proprietà da una pagina del contenuto, usare la DefaultButtonUniqueID proprietà del IButtonControl pulsante. Per altre informazioni sulle pagine master, vedere ASP.NET Pagine master.
La DefaultButton proprietà potrebbe non causare un postback negli scenari seguenti:
Premere INVIO quando lo stato attivo è esterno ai controlli di input nel modulo. L'azione di postback predefinita non è garantita per essere attivata.
Premere INVIO quando lo stato attivo si trova all'interno di una casella di testo a più righe. In una casella di testo a più righe, il comportamento previsto è che premendo INVIO crea una nuova riga nella casella di testo. In alcuni browser premere INVIO all'interno di una casella di testo a più righe attiva un postback. In tal caso, se si vuole creare una nuova riga, è possibile collegare una funzione JavaScript al controllo di input. Lo script deve acquisire la chiave ENTER e arrestare il postback. Ad esempio, è possibile usare la Attributes raccolta di proprietà per aggiungere script client per l'evento
onKeyPress.Specifica di un LinkButton controllo come pulsante predefinito. Sono supportati solo Button i controlli e ImageButton .
Modifica della DefaultButton proprietà a livello di codice durante un postback asincrono. I postback asincroni possono essere abilitati in una pagina aggiungendo uno o più UpdatePanel controlli alla pagina. Per altre informazioni, vedere Panoramica del controllo UpdatePanel e Panoramica del rendering di pagine parziali.
