Button.UseSubmitBehavior Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het Button-besturingselement gebruikmaakt van het verzendmechanisme van de clientbrowser of het ASP.NET terugzendmechanisme.
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 BooleanWaarde van eigenschap
true als het besturingselement gebruikmaakt van het verzendmechanisme van de clientbrowser; anders, false. De standaardwaarde is true.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de UseSubmitBehavior eigenschap gebruikt om het verzendmechanisme op te geven dat door een Button besturingselement wordt gebruikt wanneer het wordt teruggezet naar de server. De eigenschap UseSubmitBehavior is ingesteld op false, waardoor de knop het ASP.NET terugdraaimechanisme gebruikt. Als u de broncode voor de weergegeven pagina bekijkt met behulp van de opdracht Bronweergave van uw browser, ziet u dat het script aan de clientzijde is toegevoegd door het ASP.NET paginaframework om het formulier op de server te plaatsen.
<%@ 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>
Opmerkingen
Gebruik de eigenschap UseSubmitBehavior om op te geven of een Button-besturingselement gebruikmaakt van het verzendmechanisme van de clientbrowser of het ASP.NET terugzendmechanisme. Standaard is truede waarde van deze eigenschap, waardoor het besturingselement het Button verzendmechanisme van de browser gebruikt. Als u false opgeeft, voegt het ASP.NET paginaframework het script aan de clientzijde toe aan de pagina om het formulier op de server te plaatsen.
Wanneer de UseSubmitBehavior eigenschap is false, kunnen besturingselementontwikkelaars de GetPostBackEventReference methode gebruiken om de client-postback-gebeurtenis voor de Button. De tekenreeks die door de GetPostBackEventReference methode wordt geretourneerd, bevat de tekst van de functieaanroep aan de clientzijde en kan worden ingevoegd in een gebeurtenis-handler aan de clientzijde.
Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.
