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 HtmlForm controllo che causa 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à
Oggetto ID del controllo pulsante da visualizzare come pulsante predefinito quando viene caricato .HtmlForm Il valore predefinito è una stringa vuota ("").
Eccezioni
Il controllo a cui si fa riferimento come pulsante predefinito non è di tipo IButtonControl.
Esempio
Nell'esempio seguente viene illustrato come impostare la DefaultButton proprietà per impostare il 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 IButtonControl ad eccezione del LinkButton 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 DefaultButton proprietà da una pagina di contenuto, utilizzare la UniqueID 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:
Premendo INVIO quando lo stato attivo si trova all'esterno dei controlli di input nel modulo. Non è garantito che venga attivata l'azione di postback predefinita.
Premendo 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 consiste nel fatto che premendo INVIO viene creata una nuova riga nella casella di testo. In alcuni browser, premendo INVIO all'interno di una casella di testo a più righe viene attivato un postback. In tal caso, se si vuole che INVIO crei una nuova riga, è possibile collegare una funzione JavaScript al controllo di input. Lo script deve acquisire la chiave INVIO 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 Cenni preliminari sul controllo UpdatePanel e panoramica del rendering diPartial-Page.
