Button.UseSubmitBehavior Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Button Steuerelement den Sendemechanismus des Clientbrowsers oder den ASP.NET Postbackmechanismus verwendet.
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, setPublic Overridable Property UseSubmitBehavior As BooleanEigenschaftswert
truewenn das Steuerelement den Übermittlungsmechanismus des Clientbrowsers verwendet; andernfalls . false Der Standardwert lautet true.
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die UseSubmitBehavior Eigenschaft verwendet wird, um den Sendemechanismus anzugeben, den ein Button Steuerelement verwendet, wenn es auf dem Server zurückgibt. Die UseSubmitBehavior Eigenschaft ist auf falsefestgelegt, wodurch die Schaltfläche den ASP.NET Postbackmechanismus verwendet. Wenn Sie den Quellcode für die gerenderte Seite mithilfe des Befehls "Quelle anzeigen" Ihres Browsers anzeigen, sehen Sie, dass das clientseitige Skript vom ASP.NET Seitenframework hinzugefügt wurde, um das Formular auf dem Server zu veröffentlichen.
<%@ 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>
Hinweise
Verwenden Sie die UseSubmitBehavior Eigenschaft, um anzugeben, ob ein Button Steuerelement den Sendemechanismus des Clientbrowsers oder den ASP.NET Postbackmechanismus verwendet. Standardmäßig lautet trueder Wert dieser Eigenschaft , wodurch das Button Steuerelement den Übermittlungsmechanismus des Browsers verwendet. Wenn Sie angeben false, fügt das ASP.NET Seitenframework der Seite clientseitige Skripts hinzu, um das Formular auf dem Server zu veröffentlichen.
Wenn die UseSubmitBehavior Eigenschaft lautet false, können Steuerelemententwickler die GetPostBackEventReference Methode verwenden, um das Client-Postbackereignis für das Button. Die von der GetPostBackEventReference Methode zurückgegebene Zeichenfolge enthält den Text des clientseitigen Funktionsaufrufs und kann in einen clientseitigen Ereignishandler eingefügt werden.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.
