Button.UseSubmitBehavior 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ít egy értéket, amely jelzi, hogy a Button vezérlő az ügyfélböngésző küldési mechanizmusát vagy a ASP.NET postback mechanizmust használja-e.
public:
virtual property bool UseSubmitBehavior { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool UseSubmitBehavior { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.UseSubmitBehavior : bool with get, set
Public Overridable Property UseSubmitBehavior As Boolean
Tulajdonság értéke
trueha a vezérlő az ügyfélböngésző küldési mechanizmusát használja; egyéb esetben. false Az alapértelmezett érték a true.
- Attribútumok
Példák
Az alábbi példakód bemutatja, hogyan használható a tulajdonság a UseSubmitBehavior vezérlő által a kiszolgálóra való visszatéréskor használt küldési mechanizmus Button megadására. A UseSubmitBehavior tulajdonság értéke false, így a gomb a ASP.NET postback mechanizmust használja. Ha a böngésző Forrás megtekintése parancsával tekinti meg a renderelt oldal forráskódját, látni fogja, hogy az ügyféloldali szkriptet hozzáadta a ASP.NET lap keretrendszere az űrlap kiszolgálóra való közzétételéhez.
<%@ 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 SubmitBtn_Click(object sender, EventArgs e)
{
Message.Text = "Hello World!";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Button.UseSubmitBehavior Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.UseSubmitBehavior Example</h3>
Click the Submit button.
<br /><br />
<!--The value of the UseSubmitBehavior property
is false. Therefore the button uses the ASP.NET
postback mechanism.-->
<asp:button id="Button1"
text="Submit"
onclick="SubmitBtn_Click"
usesubmitbehavior="false"
runat="server"/>
<br /><br />
<asp:label id="Message"
runat="server"/>
</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 SubmitBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
Message.Text = "Hello World!"
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Button.UseSubmitBehavior Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.UseSubmitBehavior Example</h3>
Click the Submit button.
<br /><br />
<!--The value of the UseSubmitBehavior property
is false. Therefore the button uses the ASP.NET
postback mechanism.-->
<asp:button id="Button1"
text="Submit"
onclick="SubmitBtn_Click"
usesubmitbehavior="false"
runat="server"/>
<br /><br />
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
Megjegyzések
A UseSubmitBehavior tulajdonság segítségével megadhatja, hogy egy Button vezérlő az ügyfélböngésző küldési mechanizmusát vagy a ASP.NET postback mechanizmust használja-e. Alapértelmezés szerint ennek a tulajdonságnak az értéke az true, ami miatt a Button vezérlő a böngésző küldési mechanizmusát használja. Ha false ad meg, a ASP.NET lap keretrendszere ügyféloldali szkriptet ad hozzá a laphoz, hogy közzétehesse az űrlapot a kiszolgálón.
Ha a UseSubmitBehavior tulajdonság az false, a vezérlőfejlesztők a GetPostBackEventReference metódus használatával visszaadhatják a visszaküldött ügyféleseményt a Button. A metódus által visszaadott sztring GetPostBackEventReference tartalmazza az ügyféloldali függvényhívás szövegét, és beszúrható egy ügyféloldali eseménykezelőbe.
Ez a tulajdonság nem állítható be témák vagy stíluslaptémák szerint. További információ: ThemeableAttribute és ASP.NET Témák és bőrök.