IPostBackEventHandler.RaisePostBackEvent(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При реализации каким-либо классом серверный элемент управления подключается для обработки события, возникающего при передаче формы на сервер.
public:
void RaisePostBackEvent(System::String ^ eventArgument);
public void RaisePostBackEvent (string eventArgument);
abstract member RaisePostBackEvent : string -> unit
Public Sub RaisePostBackEvent (eventArgument As String)
Параметры
- eventArgument
- String
Метод String, который представляет необязательный аргумент события, передаваемый обработчику событий.
Примеры
В следующем примере кода определяется пользовательский серверный элемент управления button, который вызывает обратную передачу, фиксирует событие обратной RaisePostBackEventClick
передачи с помощью метода и вызывает событие на сервере.
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
Комментарии
Страница передает значение eventArgument
параметра методу RaisePostBackEvent
элемента управления, реализующего IPostBackEventHandler интерфейс . Этот элемент управления также отображает элемент HTML, который вызывает обратную передачу. Если элемент управления отрисовывает клиентский скрипт для обратной передачи, аргумент из скрипта передается в параметре eventArgument
. Если обратная передача вызвана простой операцией отправки eventArgument
, параметр имеет значение null
.
Этот метод предоставляет функциональные возможности для многих событий, реализованных html- и серверными веб-элементами управления.