IPostBackEventHandler.RaisePostBackEvent(String) Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Cuando se implementa mediante una clase, permite que un control de servidor procese un evento provocado al enviar un formulario al servidor.

public:
 void RaisePostBackEvent(System::String ^ eventArgument);

public void RaisePostBackEvent (string eventArgument);

abstract member RaisePostBackEvent : string -> unit

Public Sub RaisePostBackEvent (eventArgument As String)

Parámetros

eventArgument

String

String que representa un argumento de evento opcional que se pasará al controlador de evento.

Ejemplos

En el ejemplo de código siguiente se define un control de servidor de botón personalizado que provoca postback, captura el evento de postback mediante el RaisePostBackEvent método y genera un Click evento en el servidor.

using System;
using System.Web.UI;
using System.Collections;
using System.Collections.Specialized;

namespace CustomControls {

   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
   public class MyButton: Control, IPostBackEventHandler {

      // Defines the Click event.
      public event EventHandler Click;

      //Invoke delegates registered with the Click event.
      protected virtual void OnClick(EventArgs e) {

         if (Click != null) {
            Click(this, e);
         }
      }

      // Define the method of IPostBackEventHandler that raises change events.
      public void RaisePostBackEvent(string eventArgument){

         OnClick(new EventArgs());
      }

      protected override void Render(HtmlTextWriter output) {
         output.Write("<INPUT TYPE = submit name = " + this.UniqueID +
            " Value = 'Click Me' />");
      }
   }
}

Imports System.Web.UI
Imports System.Collections
Imports System.Collections.Specialized

Namespace CustomControls    
    
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> Public Class MyButton
        Inherits Control
        Implements IPostBackEventHandler
        
        ' Define the Click event.
        Public Event Click As EventHandler
        
        
        ' Invoke delegates registered with the Click event.
        Protected Overridable Sub OnClick(e As EventArgs)            
            RaiseEvent Click(Me, e)
        End Sub
        
        
        ' Define the method of IPostBackEventHandler that raises change events.
        Public Sub RaisePostBackEvent(eventArgument As String) _
        Implements IPostBackEventHandler.RaisePostBackEvent
        
            OnClick(New EventArgs())
        End Sub       
        
        
        Protected Overrides Sub Render(output As HtmlTextWriter)
            output.Write("<INPUT TYPE = submit name = " & Me.UniqueID & _
                " Value = 'Click Me' />")
        End Sub
        
    End Class
End Namespace

Comentarios

La página pasa el valor del eventArgument parámetro al RaisePostBackEvent método del control que implementa la IPostBackEventHandler interfaz. Este control también representa el elemento HTML que hace que se produzca el postback. Si el control representa el script del lado cliente para postback, el argumento del script se pasa en el eventArgument parámetro . Si el postback se debe a una operación de envío simple, el eventArgument parámetro es null.

Este método proporciona la funcionalidad de muchos eventos implementados por controles html y de servidor web.

Consulte también

• Control de eventos de servidor en ASP.NET páginas web