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- и серверными веб-элементами управления.

Применяется к

См. также раздел