Wizard.ActiveStepIndex プロパティ

定義

現在の WizardStepBase オブジェクトのインデックスを取得または設定します。Gets or sets the index of the current WizardStepBase object.

public:
 virtual property int ActiveStepIndex { int get(); void set(int value); };
[System.Web.UI.Themeable(false)]
public virtual int ActiveStepIndex { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.ActiveStepIndex : int with get, set
Public Overridable Property ActiveStepIndex As Integer

プロパティ値

Int32

WizardStepBase コントロールに現在表示されている Wizard のインデックス。The index of the WizardStepBase that is currently displayed in the Wizard control.

属性

例外

選択した値が、WizardSteps コレクションで定義されたウィザード ステップの数を超えています。The selected value is higher than the number of wizard steps defined in the WizardSteps collection.

プロパティを使用してコントロールのプロパティを設定する方法を次のコード例に示し ActiveStepIndex ActiveStep Wizard ます。The following code example demonstrates how to use the ActiveStepIndex property to set the ActiveStep property of the Wizard control. の値がの CheckBox1.Checked 場合 trueActiveStep プロパティはに設定されます。それ以外の場合 Wizard1.Step3 、プロパティは ActiveStep に設定され Wizard1.Step2 ます。If the value of CheckBox1.Checked is true, the ActiveStep property is set to Wizard1.Step3; otherwise, the ActiveStep property is set to Wizard1.Step2.

<%@ 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 whether the 
    // CheckBox1 CheckBox is selected.  If it is, skip to the Step2 step.
    if (Wizard1.ActiveStepIndex == Wizard1.WizardSteps.IndexOf(this.WizardStep2))
    {
      if (this.CheckBox1.Checked)
      {
        Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(this.WizardStep3);
      }
    }
  }
  
</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">
          <WizardSteps>
            <asp:WizardStep id="WizardStep1" 
              title="Step 1" 
              runat="server">
              <asp:CheckBox id="CheckBox1" 
                runat="Server" 
                text="Select this check box 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="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 whether the 
    ' CheckBox1 CheckBox is selected.  If it is, skip to the Step3 step. 
    If (Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(Me.WizardStep2)) Then
      If (Me.CheckBox1.Checked) Then
        Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(Me.WizardStep3)
      End If
    End If
  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">
          <WizardSteps>
            <asp:WizardStep id="WizardStep1" 
              title="Step 1" 
              runat="server">
              <asp:CheckBox id="CheckBox1" 
                runat="Server" 
                text="Select this check box 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>

注釈

プロパティは、 ActiveStepIndex WizardStepBase コントロールに現在表示されているオブジェクトの0から始まるインデックスを提供し Wizard ます。The ActiveStepIndex property provides the zero-based index of the WizardStepBase object that is currently displayed in the Wizard control. プログラムを使用してプロパティを設定し、実行時に ActiveStepIndex ユーザーに表示されるステップを制御できます。You can programmatically set the ActiveStepIndex property to control which step is displayed to the user at run time.

注意

Microsoft Visual Studio 2005 を使用している場合は、 ActiveStepIndex がソースビューで保持されていることに注意してください。If you are using Microsoft Visual Studio 2005, note that the ActiveStepIndex is persisted in Source view. サイドバーのボタンを WizardSteps クリックしてデザインビューのプロパティを変更し、その後ページを実行すると、 Wizard が別の手順を指している可能性があるため、コントロールの最初の手順が表示されない場合があり ActiveStepIndex ます。If you change the WizardSteps property in Design view by clicking the sidebar buttons, and you then run the page, the first step of the Wizard control might not be shown because the ActiveStepIndex might be pointing to a different step.

既定では、の値を-1 に設定すると、 ActiveStepIndex 手順がないウィザードがサポートされ、次のような動作が発生します。If you set the value of ActiveStepIndex to -1 to support a wizard with no steps by default, the following behavior occurs:

  • を宣言し ActiveStepIndex て-1 に設定した場合、または既定値として-1 に設定した場合、コントロールは常にウィザードの最初の手順を表示しようとします。If you declaratively set ActiveStepIndex to -1 or set it to -1 as a default value, the control will always try to render the first step in the wizard.

  • プログラムを使用して-1 に設定した場合 ActiveStepIndex 、コントロールはレンダリングされません。If you programmatically set ActiveStepIndex to -1, the control will not render.

このプロパティは、テーマまたはスタイル シート テーマによって設定することはできません。This property cannot be set by themes or style sheet themes. 詳細については、「」 ThemeableAttribute および「 ASP.NET Theme and スキン」を参照してください。For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

適用対象

こちらもご覧ください