IPostBackEventHandler.RaisePostBackEvent(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wanneer een klasse wordt geïmplementeerd, kan een serverbesturingselement een gebeurtenis verwerken die wordt gegenereerd wanneer een formulier op de server wordt geplaatst.
public:
void RaisePostBackEvent(System::String ^ eventArgument);
public void RaisePostBackEvent(string eventArgument);
abstract member RaisePostBackEvent : string -> unit
Public Sub RaisePostBackEvent (eventArgument As String)
Parameters
- eventArgument
- String
Een String die een optioneel gebeurtenisargument vertegenwoordigt dat moet worden doorgegeven aan de gebeurtenis-handler.
Voorbeelden
In het volgende codevoorbeeld wordt een aangepast knopserverbeheer gedefinieerd dat postback veroorzaakt, de postback-gebeurtenis met behulp van de RaisePostBackEvent methode vastlegt en een Click gebeurtenis op de server genereert.
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
Opmerkingen
De pagina geeft de waarde van de eventArgument parameter door aan de RaisePostBackEvent methode van het besturingselement waarmee de IPostBackEventHandler interface wordt geïmplementeerd. Met dit besturingselement wordt ook het HTML-element weergegeven dat ervoor zorgt dat de postback plaatsvindt. Als het besturingselement het script aan de clientzijde weergeeft voor terugpost, wordt het argument van het script doorgegeven in de eventArgument parameter. Als de postback wordt veroorzaakt door een eenvoudige verzendbewerking, is eventArgumentde null parameter .
Deze methode biedt de functionaliteit voor veel gebeurtenissen die zijn geïmplementeerd door HTML- en webserverbesturingselementen.