HtmlForm.DefaultButton Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja annak a vezérlőnek a HtmlForm gyermekvezérlését, amely az ENTER billentyű lenyomásakor visszalépést okoz.
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 StringTulajdonság értéke
A ID betöltéskor HtmlForm alapértelmezett gombként megjelenítendő gombvezérlő. Az alapértelmezett érték egy üres sztring ("").
Kivételek
Az alapértelmezett gombként hivatkozott vezérlő nem ilyen típusú IButtonControl.
Példák
Az alábbi példa bemutatja, hogyan állíthatja be a DefaultButton tulajdonságot a visszaállítást okozó alapértelmezett vezérlő beállításához.
<%@ 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>
Megjegyzések
A DefaultButton tulajdonság lehetővé teszi annak megadását, hogy a felhasználók visszalépést okozhatnak az ENTER billentyű lenyomásával az űrlap egyik beviteli vezérlőelemében (például egy szövegmezőben). Alapértelmezett gombként megadhat minden olyan vezérlőt, amely a vezérlő kivételével az IButtonControl interfészből származik LinkButton . Ha a tulajdonság által DefaultButton hivatkozott vezérlőelem nem származik, IButtonControla rendszer kivételt InvalidOperationException okoz.
Ha mesteroldalakat használ, és a DefaultButton tulajdonságot egy tartalomlapról állítja be, használja a UniqueIDIButtonControl gomb tulajdonságát. További információ a mesteroldalakról: ASP.NET Mesteroldalak.
Előfordulhat, hogy a DefaultButton tulajdonság nem okoz visszavételt a következő esetekben:
Nyomja le az ENTER billentyűt, ha a fókusz kívül esik az űrlap bemeneti vezérlőin. Az alapértelmezett visszavételi művelet nem garantáltan aktiválódik.
Nyomja le az ENTER billentyűt, ha a fókusz egy többsoros szövegmezőben van. Egy többsoros szövegmezőben a várt viselkedés az, hogy az ENTER billentyű lenyomásával új sort hoz létre a szövegdobozban. Egyes böngészőkben az ENTER billentyű lenyomása többsoros szövegmezőben utómunkát vált ki. Ebben az esetben, ha az ENTER helyett egy új sort szeretne létrehozni, csatolhat egy JavaScript-függvényt a beviteli vezérlőhöz. A szkriptnek rögzítenie kell az ENTER billentyűt, és le kell állítania a visszavételt. A tulajdonsággyűjtemény használatával Attributes például ügyfélszkriptet adhat hozzá az
onKeyPresseseményhez.LinkButton Vezérlőelem megadása alapértelmezett gombként. Csak Button és ImageButton a vezérlők támogatottak.
DefaultButton A tulajdonság programozott módosítása aszinkron utómunkák során. Az aszinkron utómunkák engedélyezhetők egy lapon egy vagy több UpdatePanel vezérlő hozzáadásával. További információ: UpdatePanel Control Overview and Partial-Page Rendering Overview.
