Wizard.MoveTo(WizardStepBase) Metoda

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í.

Nastaví zadaný WizardStepBase-odvozený objekt jako hodnotu vlastnosti ActiveStep Wizard ovládacího prvku.

public:
 void MoveTo(System::Web::UI::WebControls::WizardStepBase ^ wizardStep);

public void MoveTo (System.Web.UI.WebControls.WizardStepBase wizardStep);

member this.MoveTo : System.Web.UI.WebControls.WizardStepBase -> unit

Public Sub MoveTo (wizardStep As WizardStepBase)

Parametry

wizardStep: WizardStepBase

WizardStepBaseodvozený objekt nastavit jako ActiveStep.

Výjimky

ArgumentNullException

Hodnota objektu -odvozeného WizardStepBasepředaného je null.

ArgumentException

Přidružený ActiveStepIndex -odvozený WizardStepBaseobjekt předaný je roven -1.

Příklady

Následující příklad kódu ukazuje, jak použít metodu MoveTo k řízení ActiveStep vlastnosti Wizard ovládacího prvku. Pokud je hodnota CheckBox1.Checked , ActiveStep vlastnost je nastavena na Wizard1.Step3; v opačném případě je vlastnost nastavena ActiveStep na Wizard1.Step2.true

<%@ 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 check box is selected.  If it is, skip to the Step3 step. 
    if (Wizard1.ActiveStepIndex == Wizard1.WizardSteps.IndexOf(this.WizardStep2))
    {
      if (this.CheckBox1.Checked)
      {
        Wizard1.MoveTo(this.WizardStep3);
      }
      else
      {
        Wizard1.MoveTo(this.WizardStep2);
      }
    }
  }
  
</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>MoveTo 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 check box 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.MoveTo(Me.WizardStep3)
      Else
        Wizard1.MoveTo(Me.WizardStep2)
      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>MoveTo Example</b>
        </HeaderTemplate>
      </asp:Wizard>
    </form>
  </body>
</html>

Poznámky

Použijte metodu MoveTo k řízení, který WizardStepBase-odvozený objekt je nastaven jako hodnota vlastnosti ActiveStep v ovládacím Wizard prvku programově. Tímto způsobem můžete vlastnost dynamicky měnit ActiveStep na základě jiných podmínek během běhu.

Platí pro