IPostBackEventHandler.RaisePostBackEvent メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IPostBackEventHandler.RaisePostBackEvent メソッド

クラスによって実装された場合は、フォームがサーバーにポストされたときに発生するイベントをサーバーコントロールで処理できるようにします。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Sub RaisePostBackEvent ( _
    eventArgument As String _
)

Visual Basic (使用法)

Dim instance As IPostBackEventHandler
Dim eventArgument As String

instance.RaisePostBackEvent(eventArgument)

void RaisePostBackEvent (
    string eventArgument
)

C++

void RaisePostBackEvent (
    String^ eventArgument
)

void RaisePostBackEvent (
    String eventArgument
)

JScript

function RaisePostBackEvent (
    eventArgument : String
)

パラメータ

eventArgument: イベントハンドラに渡される省略可能なイベント引数を表す String。

解説

IPostBackEventHandler インターフェイスを実装しているコントロールの RaisePostBackEvent メソッドに、ページが eventArgument パラメータの値を渡します。このコントロールには、ポストバックを発生させる HTML 要素も表示されます。このコントロールにポストバックのクライアント側スクリプトが表示されている場合、eventArgument パラメータにこのスクリプトからの引数が渡されます。送信によってポストバックが発生した場合、eventArgument パラメータは null 参照 (Visual Basic では Nothing) です。

このメソッドは、HTML サーバーコントロールおよび Web サーバーコントロールによって実装される多くのイベントを処理する機能を提供します。

使用例

ポストバックを発生させるカスタムボタンサーバーコントロールを定義し、RaisePostBackEvent メソッドを使用してポストバックイベントをキャプチャして、サーバーで Click イベントを発生させるコード例を次に示します。

Visual Basic

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' />");   
      }
   }    
}