WizardStepBase.ID Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.
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 StringEigenschaftswert
Der programmgesteuerte Bezeichner, der dem Steuerelement zugewiesen ist.
Ausnahmen
Die Eigenschaft wurde zur Entwurfszeit auf eine ungültige Bezeichnerzeichenfolge festgelegt.
- oder -
Die Eigenschaft wurde auf denselben Bezeichner wie das enthaltende Wizard Steuerelement zur Entwurfszeit festgelegt.
- oder -
Die Eigenschaft wurde auf denselben Bezeichner festgelegt wie ein weiterer Schritt im enthaltenden Wizard Steuerelement zur Entwurfszeit.
Beispiele
Im folgenden Codebeispiel werden drei Assistentenschritte für ein Wizard Steuerelement auf einer Web Forms-Seite definiert. Im Code für die Seite werden die Instanzen des Assistentenschritts anhand ihrer ID-Werte benannt, und sie können im Code als WizardStep1, WizardStep2und 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>
Hinweise
Verwenden Sie die ID Eigenschaft, um ein bestimmtes Assistentenschritt-Steuerelement auf einer Webseite zu identifizieren und darauf zu verweisen. Der ID Wert wird zum Namen der Steuerelementinstanz auf der Seite. Dadurch können Sie auf einfache Weise auf einen bestimmten Codeschritt für diese Seite zugreifen. Wenn Sie beispielsweise die ID Eigenschaft eines WizardStepBase Steuerelements auf "Step1" festlegen, können Sie auf die untergeordneten Steuerelemente des Assistentenschritts im Code für diese Seite verweisen als Step1.Controls.
Das WizardStepBase Steuerelement stellt sicher, dass jeder Schritt in einem Wizard Steuerelement über einen gültigen eindeutigen Bezeichner verfügt, wenn die Schritte zur Entwurfszeit hinzugefügt oder geändert werden. Wenn Sie z. B. den ID Schritt zur Entwurfszeit festlegen, kann er nicht mit dem Bezeichner für einen anderen Schritt übereinstimmen, der Wizard im Steuerelement enthalten ist, und er kann nicht mit dem ID für das enthaltenden Wizard Steuerelement übereinstimmen.
