Compartilhar via


Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Método

Definição

Registra um controle de servidor ASP.NET como um que exige que um evento seja gerado quando o controle é processado no objeto Page.

public:
 virtual void RegisterRequiresRaiseEvent(System::Web::UI::IPostBackEventHandler ^ control);
public virtual void RegisterRequiresRaiseEvent (System.Web.UI.IPostBackEventHandler control);
abstract member RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit
override this.RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit
Public Overridable Sub RegisterRequiresRaiseEvent (control As IPostBackEventHandler)

Parâmetros

control
IPostBackEventHandler

O controle a ser registrado.

Exemplos

O exemplo de código a seguir usa o RegisterRequiresRaiseEvent método para registrar um Button controle de servidor Web, exigindo que um evento seja acionado. Depois de registrar o primeiro Button controle, você pode fazer com que o segundo Button controle declarado no código poste os resultados do evento de clique do primeiro botão na página.

void DisplayUserName(Object sender, EventArgs ea) 
{
   Response.Write("Welcome to " + Server.HtmlEncode(userName.Text));
}
void RaiseEvent(Object sender, EventArgs ea)
{
   // Raise a post back event for a control.
   this.RaisePostBackEvent(userButton, "");
}
void Page_Load(Object sender, EventArgs ea)
{
   // Register a control as one that requires postback handling.
   this.RegisterRequiresRaiseEvent(userButton);
}
    Sub DisplayUserName(Sender As Object, e As EventArgs) 
       Response.Write("Welcome to " + Server.HtmlEncode(userName.Text))
    End Sub

   Sub MyRaiseEvent(Sender As Object, e As EventArgs)
       'Raises a post back event for a control.
        Me.RaisePostBackEvent(userButton, "")
   End Sub 
    
    Sub Page_Load(Sender As Object, e As EventArgs)

      'Registers a control as one that requires postback handling
      Me.RegisterRequiresRaiseEvent(userButton)
  End Sub

Comentários

Somente um controle de servidor pode ser registrado por solicitação de página. O RegisterRequiresRaiseEvent deve ser usado quando o controle não inclui sua ID de controle no formulário após dados. Além disso, o controle registrado deve implementar a IPostBackEventHandler interface .

Aplica-se a

Confira também