Button.IPostBackEventHandler.RaisePostBackEvent(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 ele é clicado, para gerar um Click evento e, se definido, um Command evento.