WizardStepCollection.Insert(Int32, WizardStepBase) Methode

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.

Fügt das angegebene, von WizardStepBase abgeleitete Objekt in der Auflistung an der angegebenen Indexposition ein.

public:
 void Insert(int index, System::Web::UI::WebControls::WizardStepBase ^ wizardStep);

public void Insert(int index, System.Web.UI.WebControls.WizardStepBase wizardStep);

member this.Insert : int * System.Web.UI.WebControls.WizardStepBase -> unit

Public Sub Insert (index As Integer, wizardStep As WizardStepBase)

Parameter

index: Int32

Die Indexposition, an der das von WizardStepBase abgeleitete Objekt eingefügt wird.

wizardStep: WizardStepBase

Das von WizardStepBase abgeleitete Objekt, das der WizardStepCollection-Auflistung hinzugefügt werden soll.

Beispiele

Im folgenden Codebeispiel wird das programmgesteuerte Erstellen eines Wizard Steuerelements und die Verwendung der Insert -Methode veranschaulicht, um der WizardSteps Auflistung abgeleitete Objekte hinzuzufügenWizardStepBase. Beachten Sie, WizardSteps dass die -Eigenschaft des Wizard -Steuerelements im Beispiel eine Instanz der WizardStepCollection -Klasse ist.

ASP.NET (C#)

<%@ 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">

  // Programmatically create a Wizard control and dynamically
  // add WizardStep objects to it.    
  
  void Page_Load(object sender, EventArgs e) 
  {
    Wizard WizardControl = new Wizard();
      
    // Create some steps for the wizard and insert them
    // into the WizardStepCollection collection.
    for (int i = 0; i <= 5; i++)
    {
      WizardStepBase newStep = new WizardStep();
      newStep.ID = "Step" + (i + 1).ToString();
      WizardControl.WizardSteps.Insert(0, newStep);
    }

    WizardControl.ActiveStepIndex = 0;
    WizardControl.DisplaySideBar = true;
    
    // Display the wizard on the page.
    PlaceHolder1.Controls.Add(WizardControl);
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>WizardStepCollection Insert Example</title>
</head>
<body>
    <form id="Form1" runat="server">
      <h3>WizardStepCollection Insert Example</h3>
      <asp:PlaceHolder id="PlaceHolder1" 
        runat="server" />
    </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">

  ' Programmatically create a Wizard control and dynamically
  ' add WizardStep objects to it.    
  
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    Dim WizardControl As Wizard = New Wizard()
      
    ' Create some steps for the wizard and insert them
    ' into the WizardStepCollection collection.
    For i As Integer = 0 To 5
      Dim newStep As WizardStepBase = New WizardStep()
      newStep.ID = "Step" + (i + 1).ToString()
      WizardControl.WizardSteps.Insert(0, newStep)
    Next

    WizardControl.ActiveStepIndex = 0
    WizardControl.DisplaySideBar = True
    
    ' Display the wizard on the page.
    PlaceHolder1.Controls.Add(WizardControl)
  
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>WizardStepCollection Insert Example</title>
</head>
<body>
    <form id="Form1" runat="server">
      <h3>WizardStepCollection Insert Example</h3>
      <asp:PlaceHolder id="PlaceHolder1" 
        runat="server" />
    </form>
  </body>
</html>

Hinweise

Die Insert -Methode fügt der Auflistung am WizardStepBaseangegebenen Indexspeicherort das -abgeleitete Objekt hinzu.

Alternativ können Sie die AddAt -Methode verwenden, um der Auflistung das WizardStepBaseabgeleitete Objekt hinzuzufügen. Um am Ende der WizardStepCollection Auflistung ein abgeleitetes WizardStepBaseObjekt hinzuzufügen, verwenden Sie die Add -Methode.

Hinweis

Die Insert -Methode und die AddAt -Methode führen im Wesentlichen dieselbe Funktion aus. Wenn die Insert Methode aufgerufen wird, übergibt sie einfach die wizardStep Parameter und index an die AddAt -Methode.

Gilt für:

Produkt	Versionen
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Teilen über