Wizard.MoveTo(WizardStepBase) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Establece el objeto derivado de WizardStepBase especificado como el valor de la propiedad ActiveStep del control 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 -> unit
Public Sub MoveTo (wizardStep As WizardStepBase)
Parámetros
- wizardStep
- WizardStepBase
El objeto derivado WizardStepBase que se va a establecer en ActiveStep.
Excepciones
El valor del objeto derivado de WizardStepBase que se pasa es null
.
La propiedad ActiveStepIndex del objeto derivado de WizardStepBase asociado que se pasó es igual a -1.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el MoveTo método para controlar la ActiveStep propiedad del Wizard control . Si el valor de CheckBox1.Checked
es true
, la ActiveStep propiedad se establece Wizard1.Step3
en ; de lo contrario, la ActiveStep propiedad se establece Wizard1.Step2
en .
<%@ 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>
Comentarios
Utilice el MoveTo método para controlar qué WizardStepBaseobjeto derivado de se establece como el valor de la ActiveStep propiedad en el Wizard control mediante programación. De este modo, puede cambiar la ActiveStep propiedad dinámicamente en función de otras condiciones durante el tiempo de ejecución.