PostBackTrigger Class
Defines a control inside a UpdatePanel control as a postback control.
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
'Declaration <AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _ <AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _ Public Class PostBackTrigger _ Inherits UpdatePanelControlTrigger 'Usage Dim instance As PostBackTrigger
Use the PostBackTrigger control to enable controls inside an UpdatePanel to cause a postback instead of performing an asynchronous postback.
Use the RegisterPostBackControl method of the ScriptManager control to programmatically register a postback control. You can then call the Update method of the UpdatePanel control when the trigger control performs a postback.
Note: |
|---|
Programmatically adding PostBackTrigger controls is not supported. |
If a control is set as both a PostBackTrigger and AsyncPostBackTrigger control, an exception is thrown.
The following example shows how to declaratively define a PostBackTrigger control for an UpdatePanel control. In the panel, a FileUpload control enables users to upload a file. Users must first check whether the file to upload exists. The Button control that calls the event handler to check the file name causes an asynchronous postback. However, the Button control that uploads the file is registered as a PostBackTrigger, because files cannot be uploaded asynchronously.
<%@ 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"> Private saveDir As String = "Uploads\\" Protected Sub UploadButton_Click(ByVal sender As Object, ByVal e As EventArgs) If (FileUpload1.HasFile AndAlso FileUpload1.FileBytes.Length < 10000 AndAlso _ Not (CheckForFileName())) Then Dim savePath As String = Request.PhysicalApplicationPath & saveDir & _ Server.HtmlEncode(FileName.Text) 'Remove comment from the next line to upload file. 'FileUpload1.SaveAs(savePath) UploadStatusLabel.Text = "The file was processed successfully." Else UploadStatusLabel.Text = "You did not specify a file to upload, or a file name, or the file was too large. Please try again." End If End Sub Protected Sub CheckButton_Click(ByVal sender As Object, ByVal e As EventArgs) If (FileName.Text.Length > 0) Then Dim s As String If (CheckForFileName()) Then s = "exists already." Else s = "does not exist." End If UploadStatusLabel.Text = "The file name choosen " & s Else UploadStatusLabel.Text = "Specify a file name to check." End If End Sub Private Function CheckForFileName() As Boolean Dim fi As New System.IO.FileInfo(Request.PhysicalApplicationPath & _ saveDir & Server.HtmlEncode(FileName.Text)) Return fi.Exists End Function </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>PostBackTrigger Example</title> </head> <body> <form id="form1" runat="server"> <div> <asp:ScriptManager ID="ScriptManager1" runat="server" /> The upload button is defined as a PostBackTrigger.<br/> <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server"> <ContentTemplate> <fieldset> <legend>FileUpload in an UpdatePanel</legend> First, enter a file name to upload your file to: <asp:TextBox ID="FileName" runat="server" /> <asp:Button ID="CheckButton" Text="Check" runat="server" OnClick="CheckButton_Click" /> <br /> Then, browse and find the file to upload: <asp:FileUpload id="FileUpload1" runat="server"> </asp:FileUpload> <br /> <asp:Button id="UploadButton" Text="Upload file" OnClick="UploadButton_Click" runat="server"> </asp:Button> <br /> <asp:Label id="UploadStatusLabel" runat="server" style="color:red;"> </asp:Label> </fieldset> </ContentTemplate> <Triggers> <asp:PostBackTrigger ControlID="UploadButton" /> </Triggers> </asp:UpdatePanel> </div> </form> </body> </html>
- AspNetHostingPermission
for operating in a hosted environment. Demand value: LinkDemand. Permission value: Minimal.
- AspNetHostingPermission
for operating in a hosted environment. Demand value: InheritanceDemand. Permission value: Minimal.
System.Web.UI.UpdatePanelTrigger
System.Web.UI.UpdatePanelControlTrigger
System.Web.UI.PostBackTrigger
Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Note: