IPostBackEventHandler.RaisePostBackEvent(String) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Po zaimplementowaniu przez klasę umożliwia kontroli serwera przetwarzanie zdarzenia zgłoszonego po wysłaniu formularza na serwer.

public:
 void RaisePostBackEvent(System::String ^ eventArgument);

public void RaisePostBackEvent (string eventArgument);

abstract member RaisePostBackEvent : string -> unit

Public Sub RaisePostBackEvent (eventArgument As String)

Parametry

eventArgument

String

Element String reprezentujący opcjonalny argument zdarzenia, który ma zostać przekazany do programu obsługi zdarzeń.

Przykłady

Poniższy przykład kodu definiuje niestandardową kontrolkę serwera przycisku, która powoduje ogłaszanie zwrotne, przechwytuje zdarzenie ogłaszania zwrotnego przy użyciu RaisePostBackEvent metody i zgłasza Click zdarzenie na serwerze.

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

Uwagi

Strona przekazuje wartość parametru eventArgument do RaisePostBackEvent metody kontrolki, która implementuje IPostBackEventHandler interfejs. Ta kontrolka renderuje również element HTML, który powoduje wystąpienie ogłaszania zwrotnego. Jeśli kontrolka renderuje skrypt po stronie klienta na potrzeby ogłaszania zwrotnego, argument ze skryptu jest przekazywany w parametrze eventArgument . Jeśli ogłaszanie zwrotne jest spowodowane przez prostą operację przesyłania, eventArgument parametr to null.

Ta metoda zapewnia funkcjonalność wielu zdarzeń implementowanych przez kontrolki HTML i serwera sieci Web.

Zobacz też

• Obsługa zdarzeń serwera na stronach sieci Web ASP.NET