IPostBackEventHandler.RaisePostBackEvent(String) Methode

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Wenn sie von einer Klasse implementiert wird, kann ein Serversteuerelement ein Ereignis verarbeiten, das ausgelöst wird, wenn ein Formular auf dem Server bereitgestellt wird.

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

Parameter

eventArgument
String

Ein String Wert, der ein optionales Ereignisargument darstellt, das an den Ereignishandler übergeben werden soll.

Beispiele

Im folgenden Codebeispiel wird ein benutzerdefiniertes Schaltflächenserversteuerelement definiert, das Postback-Ereignis 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' />");
      }
   }
}

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

Hinweise

Die Seite übergibt den Wert des eventArgument Parameters an die RaisePostBackEvent Methode des Steuerelements, das die IPostBackEventHandler Schnittstelle implementiert. Dieses Steuerelement rendert auch das HTML-Element, das dazu führt, dass der Postback auftritt. Wenn das Steuerelement clientseitige Skripts für postback rendert, wird das Argument aus dem Skript im eventArgument Parameter übergeben. Wenn der Postback durch einen einfachen Sendevorgang verursacht wird, lautet eventArgumentder null Parameter .

Diese Methode stellt die Funktionalität für viele Ereignisse bereit, die von HTML- und Webserversteuerelementen implementiert werden.

Gilt für:

Weitere Informationen