Share via

Wizard.OnActiveStepChanged(Object, EventArgs) 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

引發 ActiveStepChanged 事件。

protected:
 virtual void OnActiveStepChanged(System::Object ^ source, EventArgs ^ e);
protected virtual void OnActiveStepChanged (object source, EventArgs e);
abstract member OnActiveStepChanged : obj * EventArgs -> unit
override this.OnActiveStepChanged : obj * EventArgs -> unit
Protected Overridable Sub OnActiveStepChanged (source As Object, e As EventArgs)

參數

source
Object

事件的來源。

e
EventArgs

包含事件資料的 EventArgs。

範例

下列程式碼範例示範如何使用 ActiveStepChanged 事件來更新 HeaderText 控制項的 Wizard 屬性。

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  void OnActiveStepChanged(object sender, EventArgs e)
  {
    // Every time that the ActiveStep property changes, change the HeaderText to match it.
    Wizard1.HeaderText = "You are currently on " + Wizard1.ActiveStep.Title;
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
      <form id="form1" runat="server">
        <asp:Wizard ID="Wizard1" 
          Runat="server" 
          OnActiveStepChanged="OnActiveStepChanged" 
          HeaderText="ActiveStepChanged Example">
          <WizardSteps>
            <asp:WizardStep Title="Step 1" 
              Runat="server">
            </asp:WizardStep>
            <asp:WizardStep Title="Step 2" 
              Runat="server">
            </asp:WizardStep>
          </WizardSteps>
        </asp:Wizard>
      </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  Sub OnActiveStepChanged(ByVal sender As Object, ByVal e As System.EventArgs)
    
    ' Every time that the ActiveStep property changes, change the HeaderText to match it.
    Wizard1.HeaderText = "You are currently on " + Wizard1.ActiveStep.Title
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
      <form id="form1" runat="server">
        <asp:Wizard ID="Wizard1" 
          Runat="server" 
          OnActiveStepChanged="OnActiveStepChanged" 
          HeaderText="ActiveStepChanged Example">
          <WizardSteps>
            <asp:WizardStep ID="WizardStep1" Title="Step 1" 
              Runat="server">
            </asp:WizardStep>
            <asp:WizardStep ID="WizardStep2" Title="Step 2" 
              Runat="server">
            </asp:WizardStep>
          </WizardSteps>
        </asp:Wizard>
      </form>
  </body>
</html>

備註

方法 OnActiveStepChanged 會在控制項的 Wizard 屬性變更時 ActiveStep 引發 ActiveStepChanged 事件。 當 ActiveStepChanged 控制項中顯示的 Wizard 目前步驟變更時，請使用 事件來提供其他處理。

引發事件會透過委派叫用此事件處理常式。 如需詳細資訊，請參閱 處理和引發事件。

OnActiveStepChanged 方法也允許衍生類別處理事件，而不用附加委派。 這是在衍生類別中處理事件的慣用技巧。

給繼承者的注意事項

在 OnActiveStepChanged(Object, EventArgs) 衍生類別中覆寫 方法時，請務必呼叫 OnActiveStepChanged(Object, EventArgs) 基類的 方法，讓已註冊的委派接收 事件。

適用於

另請參閱