IPostBackEventHandler.RaisePostBackEvent メソッド

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

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

構文

'宣言
Sub RaisePostBackEvent ( _
    eventArgument As String _
)
'使用
Dim instance As IPostBackEventHandler
Dim eventArgument As String

instance.RaisePostBackEvent(eventArgument)

void RaisePostBackEvent (
    string eventArgument
)

void RaisePostBackEvent (
    String^ eventArgument
)

void RaisePostBackEvent (
    String eventArgument
)

function RaisePostBackEvent (
    eventArgument : String
)

適用できません。

パラメータ

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

解説

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

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

使用例

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

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

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

その他の技術情報

ASP.NET Web ページのサーバーイベント処理

Last updated on 2007-06-26