Wizard.ActiveStepIndex Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft den Index des aktuellen WizardStepBase-Objekts ab oder legt diesen fest.

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

Eigenschaftswert

Int32

Der Index der WizardStepBase, die derzeit im Wizard-Steuerelement angezeigt wird.

Attribute
ThemeableAttribute

Ausnahmen

ArgumentOutOfRangeException

Der ausgewählte Wert ist größer als die Anzahl der in der WizardSteps-Auflistung definierten Assistentenschritte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der ActiveStepIndex -Eigenschaft zum Festlegen der ActiveStep Eigenschaft der Wizard Steuerelement. Wenn der Wert des CheckBox1.Checked ist true, ActiveStep -Eigenschaftensatz auf Wizard1.Step3ist, andernfalls die ActiveStep -Eigenschaftensatz auf 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>

Hinweise

Die ActiveStepIndex Eigenschaft enthält den nullbasierten Index des dem WizardStepBase -Objekt, das derzeit in angezeigt wird der Wizard Steuerelement. Sie können programmgesteuert festlegen der ActiveStepIndex Eigenschaft, um zu bestimmen, welcher Schritt ist für den Benutzer zur Laufzeit angezeigt.

Hinweis

Wenn Sie Microsoft Visual Studio 2005 verwenden, beachten Sie, dass die ActiveStepIndex wird in der Quellansicht beibehalten. Wenn Sie ändern die WizardSteps Eigenschaft in der Entwurfsansicht, indem Sie auf der Randleistenschaltflächen, und Sie führen Sie die Seite, der erste Schritt der Wizard Steuerelement kann nicht angezeigt werden, da die ActiveStepIndex möglicherweise auf einem anderen Schritt verweisen.

Wenn Sie festlegen, dass den Wert des ActiveStepIndex -1, um einen Assistenten keine Schritte standardmäßig zu unterstützen, tritt das folgende Verhalten:

  • Wenn Sie deklarativ festlegen ActiveStepIndex auf-1 oder auf-1 als Standardwert zugewiesen wurde, das Steuerelement immer versucht wird, den ersten Schritt im Assistenten zum Rendern.

  • Wenn Sie programmgesteuert festlegen ActiveStepIndex -1, der das Steuerelement wird nicht gerendert.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen