WizardStepBase.ID Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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

String

Der programmgesteuerte Bezeichner, der dem Steuerelement zugewiesen ist.

Ausnahmen

ArgumentException

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 auf einer Web Forms-Seite definiert. Im Code für die Seite werden die Assistentenschrittinstanzen nach ihren ID-Werten benannt, und sie können im Code als WizardStep1, WizardStep2und WizardStep3referenziert 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 Web Forms-Seite zu identifizieren und darauf zu verweisen. Der ID Wert wird zum Namen der Steuerelementinstanz auf der Seite. Dadurch können Sie problemlos 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 als Step1.Controlsverweisen.

Das WizardStepBase Steuerelement stellt sicher, dass jeder Schritt in einem Wizard Steuerelement über einen gültigen eindeutigen Bezeichner verfügt, wenn Schritte zur Entwurfszeit hinzugefügt oder geändert werden. Wenn Sie beispielsweise für ID einen Schritt zur Entwurfszeit 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:

Freigeben über