Wizard.ActiveStep プロパティとは何？わかりやすく解説 Weblio辞書

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

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

Wizard.ActiveStep プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在ユーザーに表示されている WizardSteps コレクション内のステップを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 ActiveStep As WizardStepBase

Visual Basic (使用法)

Dim instance As Wizard
Dim value As WizardStepBase

value = instance.ActiveStep

public WizardStepBase ActiveStep { get; }

C++

public:
property WizardStepBase^ ActiveStep {
    WizardStepBase^ get ();
}

/** @property */
public WizardStepBase get_ActiveStep ()

JScript

public function get ActiveStep
 () : WizardStepBase

プロパティ値
現在ユーザーに表示されている WizardStepBase。

例外

例外の種類	条件
InvalidOperationException	対応する ActiveStepIndex が -1 未満か、Wizard 内の WizardStepBase オブジェクトの数よりも大きい値です。

解説

Wizard コントロールに現在表示されている WizardStepBase オブジェクトを返す ActiveStep プロパティ。ActiveStep プロパティは読み取り専用です。ただし、ActiveStep プロパティを使用すると、現在の WizardStepBase オブジェクトのプロパティにアクセスできます。ActiveStepIndex プロパティを使用して、ActiveStep を異なる WizardStepBase オブジェクトに動的に変更します。MoveTo メソッドを使用して、ActiveStep プロパティを動的に設定することもできます。

使用例

ActiveStep プロパティを使用して、Wizard コントロールの次の ActiveStep プロパティとして設定するステップを決定する方法のコード例を次に示します。CheckBox1.Checked の値が true の場合、ActiveStep プロパティは Wizard1.Step3 に設定されます。それ以外の場合、ActiveStep プロパティは Wizard1.Step2 に設定されます。

Visual Basic

<%@ 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 EventArgs)
    ' If the ActiveStep is changing to Step2 check to see if the 
    ' CheckBox1 CheckBox is checked.  If it is then skip 
    ' to the Step3 step.
    If Wizard1.ActiveStep.Equals(Me.WizardStep2)
 Then
      If (Me.CheckBox1.Checked) Then
        Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(Me.WizardStep3)
      End If
    End If
  End Sub
  
</script>

<html  >
  <body>
      <form id="form1" runat="server">
        <asp:Wizard ID="Wizard1" 
          Runat="server"
          OnActiveStepChanged="OnActiveStepChanged">
          <WizardSteps>
            <asp:WizardStep ID="WizardStep1" 
              Title="Step 1" 
              Runat="server">
              <asp:CheckBox ID="CheckBox1" 
                Runat="Server" 
                Text="Check this checkbox to skip Step 2."
 />
                You are currently on Step 1.
            </asp:WizardStep>
            <asp:WizardStep ID="WizardStep2" 
              Title="Step 2" 
              Runat="server">
              You are currently on Step 2.
            </asp:WizardStep>
            <asp:WizardStep ID="WizardStep3" 
              Runat="server" 
              Title="Step 3">
              You are currently on Step 3.
            </asp:WizardStep>
          </WizardSteps>
          <HeaderTemplate>
            <b>ActiveStepIndex Example</b>
          </HeaderTemplate>
        </asp:Wizard>
      </form>
  </body>
</html>

<%@ 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)
  {
    // If the ActiveStep is changing to Step2 check to see if the 
    // CheckBox1 CheckBox is checked.  If it is then skip 
    // to the Step3 step.
    if (Wizard1.ActiveStep == this.WizardStep2)
    {
      if (this.CheckBox1.Checked)
      {
        Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(this.WizardStep3);
      }
    }
  }
  
</script>

<html  >
  <body>
      <form id="form1" runat="server">
        <asp:Wizard ID="Wizard1" 
          Runat="server"
          OnActiveStepChanged="OnActiveStepChanged">
          <WizardSteps>
            <asp:WizardStep ID="WizardStep1" 
              Title="Step 1" 
              Runat="server">
              <asp:CheckBox ID="CheckBox1" 
                Runat="Server" 
                Text="Check this checkbox to skip Step 2."
 />
                You are currently on Step 1.
            </asp:WizardStep>
            <asp:WizardStep ID="WizardStep2" 
              Title="Step 2" 
              Runat="server">
              You are currently on Step 2.
            </asp:WizardStep>
            <asp:WizardStep ID="WizardStep3" 
              Runat="server" 
              Title="Step 3">
              You are currently on Step 3.
            </asp:WizardStep>
          </WizardSteps>
          <HeaderTemplate>
            <b>ActiveStepIndex Example</b>
          </HeaderTemplate>
        </asp:Wizard>
      </form>
  </body>
</html>