WizardStepBase.ID Eigenschaft

Definition

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.Gets or sets the programmatic identifier assigned to the server control.

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.The programmatic identifier assigned to the control.

Ausnahmen

Die Eigenschaft wurde zur Entwurfszeit auf eine ungültige Bezeichnerzeichenfolge festgelegt.The property was set to an invalid identifier string at design time.

- oder --or- Die Eigenschaft wurde zur Entwurfszeit auf den gleichen Bezeichner wie das Wizard-Steuerelement festgelegt.The property was set to the same identifier as the containing Wizard control at design time.

- oder --or- Die Eigenschaft wurde zur Entwurfszeit auf den gleichen Bezeichner wie ein anderer Schritt im Wizard-Steuerelement festgelegt.The property was set to the same identifier as another step in the containing Wizard control at design time.

Beispiele

Im folgenden Codebeispiel werden drei Schritte des Assistenten für Wizard ein Steuerelement auf einer Web Forms Seite definiert.The following code example defines three wizard steps for a Wizard control in a Web Forms page. Im Code für die Seite werden die Instanzen des Assistenten Schritts anhand ihrer ID-Werte benannt, und auf Sie kann im Code als WizardStep1, WizardStep2und WizardStep3verwiesen werden.In code for the page, the wizard step instances are named by their ID values, and they can be referenced in the code as WizardStep1, WizardStep2, and 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 ID die-Eigenschaft, um auf einer Web Forms Seite ein bestimmtes Step-Steuerelement zu identifizieren und darauf zu verweisen.Use the ID property to identify and reference a particular wizard step control in a Web Forms page. Der ID Wert wird zum Namen der Steuerelement Instanz auf der Seite. so können Sie auf einfache Weise auf einen bestimmten Schritt im Code für diese Seite zugreifen.The ID value becomes the name of the control instance in the page; this allows you to easily access a particular step in code for that page. Wenn Sie z. b. die ID -Eigenschaft WizardStepBase eines-Steuer Elements auf "Schritt 1" festlegen, können Sie die untergeordneten Steuerelemente des Assistenten Schritts im Code für Step1.Controlsdiese Seite als referenzieren.For example, if you set the ID property of a WizardStepBase control to "Step1", you can reference the child controls of the wizard step in code for that page as Step1.Controls.

Das WizardStepBase -Steuerelement stellt sicher, dass Wizard jeder Schritt in einem-Steuerelement über einen gültigen eindeutigen Bezeichner verfügt, wenn Schritte zur Entwurfszeit hinzugefügt oder geändert werdenThe WizardStepBase control ensures that each step in a Wizard control has a valid unique identifier when steps are added or modified at design time. Wenn Sie z ID . b. für einen Schritt zur Entwurfszeit festlegen, kann der Bezeichner für einen anderen Wizard im-Steuerelement enthaltenen Schritt nicht gefunden werden, und er kann nicht Wizard mit dem ID für das enthaltende Steuerelement verglichen werden.For example, when you set the ID for a step at design time, it cannot match the identifier for another step contained in the Wizard control, and it cannot match the ID for the containing Wizard control.

Gilt für:

Siehe auch