Button.IPostBackEventHandler.RaisePostBackEvent(String) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Raises events for the Button control when it posts back to the server.

 virtual void System.Web.UI.IPostBackEventHandler.RaisePostBackEvent(System::String ^ eventArgument) = System::Web::UI::IPostBackEventHandler::RaisePostBackEvent;

void IPostBackEventHandler.RaisePostBackEvent (string eventArgument);

abstract member System.Web.UI.IPostBackEventHandler.RaisePostBackEvent : string -> unit
override this.System.Web.UI.IPostBackEventHandler.RaisePostBackEvent : string -> unit

Sub RaisePostBackEvent (eventArgument As String) Implements IPostBackEventHandler.RaisePostBackEvent

Parameters

eventArgument: String

The argument for the event.

Implements

RaisePostBackEvent(String)

Examples

The following code example demonstrates how to override the IPostBackEventHandler.RaisePostBackEvent method so that it always raises the OnClick event in a custom Button control.

namespace Samples.AspNet.CS.Controls
{
  [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
  public class CustomButtonRaisePostBackEvent : System.Web.UI.WebControls.Button, System.Web.UI.IPostBackEventHandler
  {
    private string message = System.String.Empty;

    protected override void Render(System.Web.UI.HtmlTextWriter writer) 
    {
      // Render a HTML submit button.
      writer.Write("<INPUT TYPE='submit' name='" + this.UniqueID + "' value='Click Me' />"); 
      writer.Write("<BR>" + message);
    }
    
    // Re-implement the IPostBackEventHandler's RaisePostBackEvent method.
    // Note: C# allows this, where VB.NET does not.
    public void RaisePostBackEvent(System.String eventArgument)
    {
      // Raise the Click event of the custom Button web control.
      OnClick(new System.EventArgs());

      // Don't call the Page.Validate or OnCommand events,
      // which the base IPostBackEventHandler's RaisePostBackEvent method does.
    }

    protected override void OnClick(System.EventArgs e)
    {
      message = "RaisePostBackEvent method successful!";
    }
  }
}

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Public Class CustomButtonRaisePostBackEvent
    Inherits System.Web.UI.WebControls.Button

    Private message As String = System.String.Empty

    Protected Overrides Sub Render(ByVal writer As System.Web.UI.HtmlTextWriter)
        ' Render a HTML submit button.
        writer.Write("<INPUT TYPE='submit' name='" + Me.UniqueID + "' value='Click Me' />")
        writer.Write("<BR>" + message)
    End Sub

    ' Note: VB.NET does not allow one to re-implement a base class interface, whereas C# does.
    ' Hence, just use the base class's PostBackEventHandler's RaisePostBackEvent method,
    ' which calls the OnClick method.

    Protected Overrides Sub OnClick(ByVal e As System.EventArgs)
        message = "RaisePostBackEvent method successful!"
    End Sub
End Class

Remarks

This event is used internally by the Button control, when it is clicked, to raise a Click event, and if defined, a Command event.

Applies to