IPostBackEventHandler.RaisePostBackEvent(String) Metodo

Definizione

Quando viene implementato da una classe, consente a un controllo server di elaborare un evento generato quando si invia un form al server.

public:
 void RaisePostBackEvent(System::String ^ eventArgument);
public void RaisePostBackEvent (string eventArgument);
abstract member RaisePostBackEvent : string -> unit
Public Sub RaisePostBackEvent (eventArgument As String)

Parametri

eventArgument
String

Oggetto String che rappresenta un argomento di evento facoltativo da passare al gestore eventi.

Esempio

L'esempio di codice seguente definisce un controllo server pulsante personalizzato che causa il postback, acquisisce l'evento di postback usando il RaisePostBackEvent metodo e genera un Click evento nel server.

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

Commenti

La pagina passa il valore del eventArgument parametro al RaisePostBackEvent metodo del controllo che implementa l'interfaccia IPostBackEventHandler . Questo controllo esegue anche il rendering dell'elemento HTML che causa l'esecuzione del postback. Se il controllo esegue il rendering dello script lato client per il postback, l'argomento dello script viene passato nel eventArgument parametro . Se il postback è causato da una semplice operazione di invio, il eventArgument parametro è null.

Questo metodo fornisce la funzionalità per molti eventi implementati dai controlli server HTML e Web.

Si applica a

Vedi anche