Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Regista um controlo ASP.NET servidor como aquele que exige que um evento seja levantado quando o controlo é 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 controlo para registar.

Exemplos

O exemplo de código seguinte utiliza o RegisterRequiresRaiseEvent método para registar um Button controlo de servidor Web como requerendo que um evento seja levantado. Depois de registar o primeiro Button controlo, pode fazer com que o segundo Button controlo declarado no código publique 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

Observações

Apenas um controlo de servidor pode ser registado por pedido de página. Deve RegisterRequiresRaiseEvent ser usado quando o controlo não inclui o seu ID de controlo no formulário post data. Além disso, o controlo registado deve implementar a IPostBackEventHandler interface.

Aplica-se a

Ver também