IPostBackEventHandler.RaisePostBackEvent-Methode
Ermöglicht einem Serversteuerelement bei der Implementierung durch eine Klasse das Verarbeiten eines Ereignisses, das bei der Rücksendung eines Formulars an den Server ausgelöst wird.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Sub RaisePostBackEvent ( _
eventArgument As String _
)
'Usage
Dim instance As IPostBackEventHandler
Dim eventArgument As String
instance.RaisePostBackEvent(eventArgument)
void RaisePostBackEvent (
string eventArgument
)
void RaisePostBackEvent (
String^ eventArgument
)
void RaisePostBackEvent (
String eventArgument
)
function RaisePostBackEvent (
eventArgument : String
)
Parameter
- eventArgument
Ein String, der ein optionales Ereignisargument darstellt, das an den Ereignishandler übergeben wird.
Hinweise
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 wiedergibt, wird das Argument vom Skript im eventArgument-Parameter übergeben. Wenn das Postback durch einen einfachen Übertragungsvorgang verursacht wird, ist der eventArgument-Parameter NULL (Nothing in Visual Basic).
Diese Methode stellt einen Funktionsrahmen für viele Ereignisse bereit, die von HTML- und Webserversteuerelementen implementiert werden.
Beispiel
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.
Imports System
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
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' />");
}
}
}
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
IPostBackEventHandler-Schnittstelle
IPostBackEventHandler-Member
System.Web.UI-Namespace