Wizard.MoveTo(WizardStepBase) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將指定之 WizardStepBase 衍生物件設定為 ActiveStep 控制項的 Wizard 屬性值。
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 -> unitPublic Sub MoveTo (wizardStep As WizardStepBase)參數
- wizardStep
- WizardStepBase
要設定為 WizardStepBase 之 ActiveStep 衍生物件。
例外狀況
傳入的 WizardStepBase 衍生物件值為 null。
傳入之關聯 ActiveStepIndex 衍生物件的 WizardStepBase 等於 -1。
範例
下列程式代碼範例示範如何使用 MoveTo 方法來控制 ActiveStep 控件的 Wizard 屬性。 如果的值為 CheckBox1.Checkedtrue，則 ActiveStep 屬性會設定為 Wizard1.Step3， ActiveStep 否則屬性會設定為 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 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>
備註
MoveTo使用方法來控制WizardStepBase哪一個衍生物件是以程序設計方式設定為 控件中 Wizard 屬性的值ActiveStep。 如此一來，您就可以根據運行時間期間的其他條件動態變更 ActiveStep 屬性。
