Wizard.ActiveStepIndex Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de index van het huidige WizardStepBase object opgehaald of ingesteld.
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, setPublic Overridable Property ActiveStepIndex As IntegerWaarde van eigenschap
De index van de WizardStepBase index die momenteel in het Wizard besturingselement wordt weergegeven.
- Kenmerken
Uitzonderingen
De geselecteerde waarde is hoger dan het aantal wizardstappen dat is gedefinieerd in de WizardSteps verzameling.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de ActiveStepIndex eigenschap gebruikt om de ActiveStep eigenschap van het Wizard besturingselement in te stellen. Als de waarde CheckBox1.Checked is true, wordt de ActiveStep eigenschap ingesteld op Wizard1.Step3; anders wordt de ActiveStep eigenschap ingesteld op 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>
Opmerkingen
De ActiveStepIndex eigenschap biedt de op nul gebaseerde index van het WizardStepBase object dat momenteel in het Wizard besturingselement wordt weergegeven. U kunt de ActiveStepIndex eigenschap programmatisch instellen om te bepalen welke stap tijdens de runtime aan de gebruiker wordt weergegeven.
Note
Als u Microsoft Visual Studio 2005 gebruikt, moet u er rekening mee houden dat de ActiveStepIndex behouden blijft in de bronweergave. Als u de eigenschap wijzigt in de WizardSteps ontwerpweergave door op de zijbalkknoppen te klikken en vervolgens de pagina uit te voeren, wordt de eerste stap van het Wizard besturingselement mogelijk niet weergegeven omdat het ActiveStepIndex mogelijk naar een andere stap wijst.
Als u de waarde van -1 instelt ter ondersteuning van ActiveStepIndex een wizard zonder standaard stappen, treedt het volgende gedrag op:
Als u declaratief instelt ActiveStepIndex op -1 of instelt op -1 als standaardwaarde, probeert het besturingselement altijd de eerste stap in de wizard weer te geven.
Als u programmatisch instelt ActiveStepIndex op -1, wordt het besturingselement niet weergegeven.
Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.
