ویژگی UseSubmitBehavior ASP.NET

تعریف و استفاده

ویژگی UseSubmitBehavior مشخص می‌کند که کنترل دکمه از عملکرد ارسال درون‌گرای مرورگر استفاده کند یا از مکانیزم postback ASP.NET استفاده کند.

این ویژگی به TRUE تنظیم شده است، اگر کنترل از مکانیزم ارسال مرورگر استفاده می‌کند. در غیر این صورت FALSE است. مقدار پیش‌فرض TRUE است.

وقتی که به FALSE تنظیم شود، ASP.NET یک اسکریپت کاربر به بازگشت فرم اضافه می‌کند.

وقتی که ویژگی UseSubmitBehavior به FALSE تنظیم شود، توسعه‌دهندگان کنترل می‌توانند از روش GetPostBackEventReference برای بازگرداندن رویداد بازگشت کاربر به دکمه استفاده کنند. متد GetPostBackEventReference یک رشته شامل متن فراخوانی کاربردهای کاربر را بازمی‌گرداند که می‌توان آن را به برنامه‌های رویدادهای کاربر اضافه کرد.

نحوه‌ی نوشتن

<asp:Button UseSubmitBehavior="TRUE|FALSE" runat="server" />

مثال

مثال زیر از مکانیزم postback ASP.NET استفاده می‌کند:

<script runat="server">
Sub SubmitBtn(obj As Object, e As EventArgs)
  lblMsg.Text = "Submitted using the ASP.NET postback mechanism."
End Sub
</script>
<form runat="server">
دکمه را کلیک کنید:
<asp:button id="Button1" runat="server"
Text="Submit" onclick="SubmitBtn" 
UseSubmitBehavior="FALSE" />
<br />
<asp:label id="lblMsg" runat="server"/>
</form>

مثال

استفاده از مکانیزم postback ASP.NET در کنترل دکمه