Button.IPostBackEventHandler.RaisePostBackEvent(String) Método

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Aciona eventos para o controle Button quando ele executa um postback para o servidor.

 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

Parâmetros

eventArgument

String

O argumento para o evento.

Implementações

RaisePostBackEvent(String)

Exemplos

O exemplo de código a seguir demonstra como substituir o IPostBackEventHandler.RaisePostBackEvent método para que ele sempre gere o OnClick evento em um controle personalizado Button .

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

Comentários

Esse evento é usado internamente pelo Button controle, quando é clicado, para gerar um Click evento e, se definido, um Command evento.

Confira também

• Click
• Command
• Controles de servidor Web de botão