Button.IPostBackEventHandler.RaisePostBackEvent(String) 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

回傳至伺服器時，便會引發 Button 控制項的事件。

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

void IPostBackEventHandler.RaisePostBackEvent (string eventArgument);

abstract member System.Web.UI.IPostBackEventHandler.RaisePostBackEvent : string -> unit
override this.System.Web.UI.IPostBackEventHandler.RaisePostBackEvent : string -> unit

Sub RaisePostBackEvent (eventArgument As String) Implements IPostBackEventHandler.RaisePostBackEvent

參數

eventArgument

String

事件的引數。

實作

RaisePostBackEvent(String)

範例

下列程式代碼範例示範如何覆寫 IPostBackEventHandler.RaisePostBackEvent 方法，使其一律在自定義Button控件中引發 OnClick 事件。

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!";
    }
  }
}

<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

備註

控件在 Button 內部使用這個事件，當單擊該事件時，會引發 Click 事件，如果已定義，則為 Command 事件。

另請參閱

• Click
• Command
• 按鈕網頁伺服器控制件