WizardStepBase.ID 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 programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen.
public:
virtual property System::String ^ ID { System::String ^ get(); void set(System::String ^ value); };public override string ID { get; set; }member this.ID : string with get, setPublic Overrides Property ID As StringWaarde van eigenschap
De programmatische id die aan het besturingselement is toegewezen.
Uitzonderingen
De eigenschap is ingesteld op een ongeldige id-tekenreeks tijdens het ontwerp.
– of –
De eigenschap is ingesteld op dezelfde id als het besturingselement in Wizard het ontwerp.
– of –
De eigenschap is ingesteld op dezelfde id als een andere stap in het besturingselement Wizard in het ontwerp.
Voorbeelden
In het volgende codevoorbeeld worden drie wizardstappen voor een Wizard besturingselement op een webpagina met webformulieren gedefinieerd. In code voor de pagina worden de exemplaren van de wizardstap benoemd op basis van hun id-waarden en kunnen ze in de code worden verwezen als WizardStep1, WizardStep2en WizardStep3.
<%@ 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 if the
// CheckBox1 CheckBox is checked. If it is then skip
// to the Step3 step.
if (Wizard1.ActiveStep == 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="Check this checkbox 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 if the
' CheckBox1 CheckBox is checked. If it is then skip
' to the Step3 step.
If Wizard1.ActiveStep.Equals(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="Check this checkbox 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
Gebruik de ID eigenschap om een bepaald wizardstapbesturingselement op een webpagina met webformulieren te identificeren en ernaar te verwijzen. De ID waarde wordt de naam van het besturingselementexemplaren op de pagina. Hierdoor hebt u eenvoudig toegang tot een bepaalde stap in code voor die pagina. Als u bijvoorbeeld de ID eigenschap van een WizardStepBase besturingselement instelt op 'Stap1', kunt u verwijzen naar de onderliggende besturingselementen van de wizardstap in code voor die pagina als Step1.Controls.
Het WizardStepBase besturingselement zorgt ervoor dat elke stap in een Wizard besturingselement een geldige unieke id heeft wanneer stappen tijdens het ontwerp worden toegevoegd of gewijzigd. Wanneer u bijvoorbeeld de voor een stap tijdens het ID ontwerp instelt, kan deze niet overeenkomen met de id voor een andere stap in het Wizard besturingselement en kan deze niet overeenkomen met het ID besturingselement dat het besturingselement bevat Wizard .
