IPostBackEventHandler.RaisePostBackEvent-Methode

Die Seite übergibt den Wert des eventArgument-Parameters an die RaisePostBackEvent-Methode des Steuerelements, das die IPostBackEventHandler-Schnittstelle implementiert. Dieses Steuerelement gibt auch das HTML-Element wieder, das das Postback auslöst. Wenn das Steuerelement clientseitiges Skript für Postback rendert, wird das Argument vom Skript im eventArgument-Parameter übergeben. Wenn das Postback durch einen einfachen Übertragungsvorgang verursacht wird, ist der eventArgument-Parameter null.

Diese Methode stellt einen Funktionsrahmen für viele Ereignisse bereit, die von HTML- und Webserversteuerelementen implementiert werden.

Im folgenden Codebeispiel wird ein benutzerdefiniertes Schaltflächen-Serversteuerelement definiert, das ein Postback auslöst, das anschließende Postbackereignis mithilfe der RaisePostBackEvent-Methode erfasst und ein Click-Ereignis auf dem Server auslöst.

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' />");   
      }
   }    
}
   

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen