Wizard.ActiveStepIndex Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví index aktuálního WizardStepBase objektu.

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

Hodnota vlastnosti

Int32

Index objektu WizardStepBase , který je aktuálně zobrazen v ovládacím Wizard prvku.

Atributy: ThemeableAttribute

Výjimky

ArgumentOutOfRangeException

Vybraná hodnota je vyšší než počet kroků průvodce definovaných v kolekci WizardSteps .

Příklady

Následující příklad kódu ukazuje, jak pomocí ActiveStepIndex vlastnosti nastavit ActiveStep vlastnost Wizard ovládacího prvku. Pokud je truehodnota parametru CheckBox1.Checked , ActiveStep vlastnost je nastavena na Wizard1.Step3; v opačném případě je vlastnost nastavena ActiveStep na Wizard1.Step2hodnotu .

<%@ 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>

Poznámky

Vlastnost ActiveStepIndex poskytuje nulový index objektu WizardStepBase , který je aktuálně zobrazen v ovládacím Wizard prvku. Vlastnost můžete programově nastavit tak ActiveStepIndex , aby řídila, který krok se zobrazí uživateli za běhu.

Poznámka

Pokud používáte Microsoft Visual Studio 2005, mějte na ActiveStepIndex paměti, že je trvale uložen v zobrazení zdroje. Pokud změníte WizardSteps vlastnost v návrhovém zobrazení kliknutím na tlačítka bočního Wizard panelu a pak spustíte stránku, nemusí se první krok ovládacího prvku zobrazit, protože ActiveStepIndex může odkazovat na jiný krok.

Pokud nastavíte hodnotu -1 pro podporu průvodce bez výchozího ActiveStepIndex postupu, dojde k následujícímu chování:

Pokud deklarativně nastavíte ActiveStepIndex hodnotu -1 nebo ji nastavíte na hodnotu -1 jako výchozí hodnotu, ovládací prvek se vždy pokusí vykreslit první krok průvodce.
Pokud programově nastavíte ActiveStepIndex na hodnotu -1, ovládací prvek se nevykreslí.

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET motivy a vzhledy.

Platí pro