Freigeben über


WizardStepCollection.Insert(Int32, WizardStepBase) Methode

Definition

Fügt das angegebene WizardStepBaseabgeleitete Objekt an der angegebenen Indexposition in die Auflistung 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 WizardStepBaseabgeleitete Objekt eingefügt werden soll.

wizardStep
WizardStepBase

Das WizardStepBaseabgeleitete Objekt, das in die WizardStepCollection Auflistung eingefügt werden soll.

Beispiele

Im folgenden Codebeispiel wird das programmgesteuerte Erstellen eines Wizard Steuerelements und die Verwendung der Insert Methode zum Hinzufügen WizardStepBasevon -abgeleiteten Objekten zur WizardSteps Auflistung veranschaulicht. Beachten Sie, dass die WizardSteps Eigenschaft des Wizard Steuerelements im Beispiel eine Instanz der WizardStepCollection Klasse ist.

<%@ 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 an der angegebenen Indexposition das WizardStepBaseabgeleitete Objekt hinzu.

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

Hinweis

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

Gilt für:

Weitere Informationen