Button.System.Web.UI.IPostBackEventHandler.RaisePostBackEvent メソッド

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

Button.System.Web.UI.IPostBackEventHandler.RaisePostBackEvent メソッド

サーバーへのポストバック時に、Button コントロールのイベントを発生させます。

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

Visual Basic (宣言)

Private Sub System.Web.UI.IPostBackEventHandler.RaisePostBackEvent
 ( _
    eventArgument As String _
) Implements IPostBackEventHandler.RaisePostBackEvent

Visual Basic (使用法)

Dim instance As Button
Dim eventArgument As String

CType(instance, IPostBackEventHandler).RaisePostBackEvent(eventArgument)

C#

void IPostBackEventHandler.RaisePostBackEvent (
    string eventArgument
)

C++

private:
virtual void System.Web.UI.IPostBackEventHandler.RaisePostBackEvent
 (
    String^ eventArgument
) sealed = IPostBackEventHandler::RaisePostBackEvent

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

eventArgument

イベントの引数。

解説

このイベントは、Button コントロールによって内部的に使用され、クリックされたときに Click イベントを発生させます。また、定義されている場合は Command イベントを発生させます。

使用例

カスタム Button コントロールで常に OnClick イベントが発生するように、System.Web.UI.IPostBackEventHandler.RaisePostBackEvent メソッドをオーバーライドする方法を次のコード例に示します。

Visual Basic

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
Public Class CustomButtonRaisePostBackEvent
    Inherits System.Web.UI.WebControls.Button

    Private message As String
 = System.String.Empty

    Protected Overrides Sub
 Render(ByVal writer As System.Web.UI.HtmlTextWriter)
        ' Render a HTML submit button.
        writer.Write("<INPUT TYPE='submit' name='" + Me.UniqueID
 + "' value='Click Me' />")
        writer.Write("<BR>" + message)
    End Sub

    ' Note: VB.NET does not allow one to re-implement a base class interface,
 whereas C# does.
    ' Hence, just use the base class's PostBackEventHandler's RaisePostBackEvent
 method,
    ' which calls the OnClick method.

    Protected Overrides Sub
 OnClick(ByVal e As System.EventArgs)
        message = "RaisePostBackEvent method successful!"
    End Sub
End Class

C#

namespace Samples.AspNet.CS.Controls
{
  [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name="FullTrust")]
  public class CustomButtonRaisePostBackEvent
 : System.Web.UI.WebControls.Button, System.Web.UI.IPostBackEventHandler
  {
    private string message = System.String.Empty;

    protected override void Render(System.Web.UI.HtmlTextWriter
 writer) 
    {
      // Render a HTML submit button.
      writer.Write("<INPUT TYPE='submit' name='" + this.UniqueID
 + "' value='Click Me' />"); 
      writer.Write("<BR>" + message);
    }
    
    // Re-implement the IPostBackEventHandler's RaisePostBackEvent method.
    // Note: C# allows this, where VB.NET does not.
    public void RaisePostBackEvent(System.String
 eventArgument)
    {
      // Raise the Click event of the custom Button web control.
      OnClick(new System.EventArgs());

      // Don't call the Page.Validate or OnCommand events,
      // which the base IPostBackEventHandler's RaisePostBackEvent method
 does.
    }

    protected override void OnClick(System.EventArgs
 e)
    {
      message = "RaisePostBackEvent method successful!";
    }
  }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Button クラス
Button メンバ
System.Web.UI.WebControls 名前空間
Click
Command
その他の技術情報
Button Web サーバー コントロール