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, set
Public Overrides Property ID As String
Eigenschaftswert
Der programmgesteuerte Bezeichner, der dem Steuerelement zugewiesen ist.
Ausnahmen
Die Eigenschaft wurde zur Entwurfszeit auf eine ungültige Bezeichnerzeichenfolge festgelegt.
- oder -
Die Eigenschaft wurde zur Entwurfszeit auf den gleichen Bezeichner wie das Wizard-Steuerelement festgelegt.
- oder -
Die Eigenschaft wurde zur Entwurfszeit auf den gleichen Bezeichner wie ein anderer Schritt im Wizard-Steuerelement festgelegt.
Beispiele
Im folgenden Codebeispiel werden drei Assistentenschritte für ein Wizard Steuerelement in einer Web Forms Seite definiert. Im Code für die Seite werden die Assistentenschrittinstanzen nach ihren ID-Werten benannt und können im Code als WizardStep1
, WizardStep2
und WizardStep3
referenziert werden.
<%@ 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 Assistentenschrittsteuerelement auf einer seite Web Forms zu identifizieren und darauf zu verweisen. Der ID Wert wird zum Namen der Steuerelementinstanz auf der Seite. Dadurch können Sie ganz einfach auf einen bestimmten Codeschritt für diese Seite zugreifen. Wenn Sie beispielsweise die ID -Eigenschaft eines WizardStepBase Steuerelements auf "Step1" festlegen, können Sie im Code für diese Seite auf Step1.Controls
die untergeordneten Steuerelemente des Assistentenschritts verweisen.
Das WizardStepBase Steuerelement stellt sicher, dass jeder Schritt in einem Wizard Steuerelement über einen gültigen eindeutigen Bezeichner verfügt, wenn Zur Entwurfszeit Schritte hinzugefügt oder geändert werden. Wenn Sie z. B. zur ID Entwurfszeit für einen Schritt festlegen, kann es nicht mit dem Bezeichner für einen anderen Schritt im Wizard Steuerelement übereinstimmen, und es kann nicht mit dem ID für das enthaltende Wizard Steuerelement übereinstimmen.
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Feedback senden und anzeigen für