WizardStepCollection.Insert(Int32, WizardStepBase) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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 zum Hinzufügen WizardStepBasevon abgeleiteten Objekten zur WizardSteps Auflistung veranschaulicht. Beachten Sie, dass im Beispiel die WizardSteps Eigenschaft des Wizard Steuerelements 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 das WizardStepBaseabgeleitete Objekt der Auflistung hinzuzufügen. Verwenden Sie die Add Methode, um dem 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, übergibt sie einfach die wizardStep Und-Parameter index an die AddAt Methode.

Gilt für

Siehe auch